feat: libs

Author: faretek1

docs/API/existing-libraries.md

@@ -0,0 +1,23 @@
+There exist a number of pre-existing libraries for interacting with the scratch API
+
+!!! warning
+
+    This is not a complete list
+
+=== "Python"
+    - ## [ScratchAttach](https://github.com/TimMcCool/scratchattach)
+      A sync (developing async) python library for the scratch API and other site features.
+    - ## [Scapi](https://github.com/kakeruzoku/scapi)
+      An async python library for the scratch web API, using aiohttp. Docs in Japanese.
+
+    ??? Warning "Deprecated libraries:"
+
+        - [scratchcloud](https://github.com/yuwex/scratchcloud)
+        - [scratchclient](https://github.com/CubeyTheCube/scratchclient)
+        - [node-scratch-client](https://www.npmjs.com/package/node-scratch-client)
+        - [scratch-api (js)](https://github.com/trumank/scratch-api)
+
+=== "TypeScript"
+    
+    - ## [ScratchAttach.ts](https://github.com/scratch-api/scratchattach.ts)
+      An async TypeScript library for the scratch API (missing features)

docs/API/index.md

@@ -1,4 +1,15 @@
-# Scratch Web API
+# API
+
+API stands for application-programmer-interface. Essentially what this means is a way to integrate your code
+with scratch.
+
+Scratch itself provides a number of urls which can be used for interaction via web requests, shown [below](#web-api).
+
+!!! info 
+
+    It is recommended to use an [existing library](existing-libraries) to interact with scratch instead of making your own
+
+## Web API
 
 In order to make requests to scratch, there are a multitude of different urls where you can make
 `GET`, `POST`, `PUT`, `DELETE` and other types of request.
@@ -9,6 +20,8 @@ These urls can be generally categorized by their subdomain and/or path.
 
     This is not a complete list.
 
+### Scratch
+
 | URL                                        | Purpose                                                                                                                         |
 |--------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------|
 | https://scratch.mit.edu/                   | The main website                                                                                                                |
@@ -23,14 +36,14 @@ These urls can be generally categorized by their subdomain and/or path.
 | https://cdn.scratch.mit.edu                | Content delivery network - hosts images, css, js, emojis, etc.                                                                  |
 | https://synthesis-service.scratch.mit.edu  | Text2Speech requests - which the Text2Speech extension uses                                                                     |
 
-## Ocular
+### Ocular
 
 | URL                                | Purpose                                       |
 |------------------------------------|-----------------------------------------------|
 | https://jeffalo.net/api/           | Jeffalo's API                                 |
 | https://my-ocular.jeffalo.net/api/ | API for [ocular](https://ocular.jeffalo.net/) |
 
-## TurboWarp
+### TurboWarp
 
 | URL | Purpose |
 |-----|---------|