docs: improvements

Author: Exanthiax

documentation/ecoscrolls/api.md

@@ -3,15 +3,18 @@ title: "API"
 sidebar_position: 7
 ---
 
-## Source Code
+This page is for developers who want to hook into EcoScrolls from their own plugin. EcoScrolls is open-source, so you can read the code, depend on it, and build against its API.
 
-The source code can be found [here](https://github.com/Auxilor/EcoScrolls):
+## Source code
 
-## API
+The full source is on GitHub at [Auxilor/EcoScrolls](https://github.com/Auxilor/EcoScrolls).
 
-Add this to your build.gradle.kts:
+## Adding the dependency
 
-```kts
+1. Add the Auxilor repository to your `build.gradle.kts`.
+2. Add EcoScrolls as a `compileOnly` dependency.
+
+```kotlin
 repositories {
     maven("https://repo.auxilor.io/repository/maven-public/")
 }
@@ -21,4 +24,11 @@ dependencies {
 }
 ```
 
-The latest version available on the repo can be found [here](https://github.com/Auxilor/EcoScrolls/tags)
+The latest version available on the repo can be found [here](https://github.com/Auxilor/EcoScrolls/tags).
+
+<hr/>
+
+## Where to go next
+
+- **eco framework:** the shared APIs EcoScrolls builds on live in [eco](https://github.com/Auxilor/eco).
+- **Make a scroll:** the config side of scrolls in [How to Make a Scroll](how-to-make-a-scroll).

documentation/ecoscrolls/commands-and-permissions.md

@@ -3,11 +3,20 @@ title: "Commands and Permissions"
 sidebar_position: 5
 ---
 
-| Command                                          | Description                                             | Permission                           |
-|--------------------------------------------------|---------------------------------------------------------|--------------------------------------|
-| `/ecoscrolls reload`                             | Reloads the plugin                                      | `ecoscrolls.command.reload`          |
-| `/inscribe`                                      | Opens the inscription GUI                               | `ecoscrolls.command.inscribe`        |
-| `/ecoscrolls inscribe <player> <scroll> [level]` | Inscribe the held item                                  | `ecoscrolls.command.inscribedirect` |
-| `/ecoscrolls give <player> <scroll> [quantity]`  | Give the player an EcoScroll                             | `ecoscrolls.command.give`            |
-| `/ecoscrolls import <id>`                        | Import a scroll from [lrcdb](https://lrcdb.auxilor.io/) | `ecoscrolls.command.import`          |
-| `/ecoscrolls export <id>`                        | Export a scroll to [lrcdb](https://lrcdb.auxilor.io/)   | `ecoscrolls.command.export`          |
+Every EcoScrolls command and the permission node that gates it. Op players have all of these by default; grant the individual nodes to give non-op players access.
+
+| Command | Description | Permission |
+| --- | --- | --- |
+| `/ecoscrolls reload` | Reloads the plugin | `ecoscrolls.command.reload` |
+| `/inscribe` | Opens the Inscription Table GUI | `ecoscrolls.command.inscribe` |
+| `/ecoscrolls inscribe <player> <scroll> [level]` | Inscribes the held item | `ecoscrolls.command.inscribedirect` |
+| `/ecoscrolls give <player> <scroll> [quantity]` | Gives the player a scroll | `ecoscrolls.command.give` |
+| `/ecoscrolls import <id>` | Imports a scroll from lrcdb | `ecoscrolls.command.import` |
+| `/ecoscrolls export <id>` | Exports a scroll to lrcdb | `ecoscrolls.command.export` |
+
+<hr/>
+
+## Where to go next
+
+- **Make a scroll:** build a scroll to give or inscribe in [How to Make a Scroll](how-to-make-a-scroll).
+- **Community configs:** import ready-made scrolls from [lrcdb](https://lrcdb.auxilor.io/).