docs: add challenge admin docs

Author: ginkoid

docs/content/configuration.md

@@ -62,10 +62,10 @@ YAML/JSON name|environment name|required|default value|type|description
 `meta.imageUrl`|`RCTF_IMAGE_URL`|yes|`''`|string|OpenGraph and Twitter embed image URL
 `logoUrl`|`RCTF_LOGO_URL`|no|_(none)_|string|URL to raster image of the CTF's logo. used in emails
 `globalSiteTag`|`RCTF_GLOBAL_SITE_TAG`|no|_(none)_|string|Google Analytics site tag
-`challengeProvider`|_(none)_|yes|`database`|provider|provider for challenges. [See challenge provider doc for more](../providers/challenges/index)
-`uploadProvider`|_(none)_|yes|`local`|provider|provider for challenge file uploads. [See upload provider doc for more](../providers/uploads/index)
-`email.provider`|_(none)_|no|_(none)_|provider|provider for email sending. [See email doc for more](../providers/emails/index)
-`email.from`|_(none)_|no|_(none)_|provider|`from:` address when sending email. [See email doc for more](../providers/emails/index)
+`challengeProvider`|_(none)_|yes|`database`|provider|provider for challenges. [See challenge provider doc for more](../providers/challenges)
+`uploadProvider`|_(none)_|yes|`local`|provider|provider for challenge file uploads. [See upload provider doc for more](../providers/uploads)
+`email.provider`|_(none)_|no|_(none)_|provider|provider for email sending. [See email doc for more](../providers/emails)
+`email.from`|_(none)_|no|_(none)_|provider|`from:` address when sending email. [See email doc for more](../providers/emails)
 `divisions`|_(none)_|yes|_(none)_|object|division IDs and their respective names. [See division doc for more](../management/divisions)
 `defaultDivision`|_(none)_|no|_(none)_|string|default division ID. [See division doc for more](../management/divisions)
 `divisionACLs`|_(none)_|no|_(none)_|array|ACLs for restricting division access. [See division doc for more](../management/divisions)

docs/content/index.md

@@ -2,3 +2,5 @@
 
 rCTF is redpwnCTF's CTF platform. It is developed and maintained by the
 [redpwn](https://redpwn.net) CTF team.
+
+To install rCTF, see [the installation doc](installation).

docs/content/installation.md

@@ -5,3 +5,11 @@ You can install rCTF in one command with [the installer script](https://get.rctf
 ```bash
 curl https://get.rctf.redpwn.net | sh
 ```
+
+## After installation
+
+To configure rCTF, see [the configuration doc](../configuration).
+
+To update the CTF's challenges, see [the admin doc](../management/admin).
+
+To scale up rCTF, see the [migration](../management/migration) and [scaling](../management/scaling) docs.

docs/content/management/admin.md

@@ -0,0 +1,13 @@
+# Challenge Admin
+
+rCTF integrates with [rCDS](https://github.com/redpwn/rcds), which can automatically deploy challenges and sync them to rCTF.
+
+To use rCTF without rCDS, create an admin user normally. Then, connect to postgreSQL and run:
+```sql
+UPDATE users SET perms=3 WHERE id='your user id';
+```
+
+After running, you can manage the CTF's challenges using a web UI at:
+```
+https://your-rctf.example.com/admin/challs
+```

docs/content/providers/challenges/database.md

@@ -1,6 +1,6 @@
 # Database Challenge Provider
 
-The database challenge provider stores challenge details in the Postgresql database. To use it, specify `challenges/database` for the challenge provider name.
+The database challenge provider stores challenge details in the postgreSQL database. To use it, specify `challenges/database` for the challenge provider name.
 
 ## Configuration Example
 

docs/content/providers/emails/index.md

@@ -1,6 +1,7 @@
 # Email Provider Index
 
-Email providers send emails to competitors. In rCTF, Emails are used for registration, email updates, and recovery. At the moment, there are three email providers available:
+Email providers send emails to competitors. In rCTF, emails are used for registration, email updates, and recovery. At the moment, there are three email providers available:
+
 * [Mailgun](mailgun)
 * [SES](ses)
 * [SMTP](smtp)

docs/content/providers/uploads/index.md

@@ -1,5 +1,6 @@
 # Upload Provider Index
 
 Upload providers store files for each challenge. At the moment, there are two upload providers available:
+
 * [Google Cloud Storage](gcs)
 * [Local](local)

docs/mkdocs.yml

@@ -3,6 +3,34 @@ site_description: rCTF Documentation
 site_author: redpwn
 site_url: https://rctf.redpwn.net
 
+nav:
+  - Home: index.md
+  - Installation: installation.md
+  - Configuration: configuration.md
+  - Management:
+    - Divisions: management/divisions.md
+    - Home: management/home.md
+    - Migration: management/migration.md
+    - Scaling: management/scaling.md
+  - Providers:
+    - Index: providers/index.md
+    - Challenges:
+      - Index: providers/challenges/index.md
+      - Database: providers/challenges/database.md
+    - Emails:
+      - Index: providers/emails/index.md
+      - Mailgun: providers/emails/mailgun.md
+      - SES: providers/emails/ses.md
+      - SMTP: providers/emails/smtp.md
+    - Uploads:
+      - Index: providers/uploads/index.md
+      - GCS: providers/uploads/gcs.md
+      - Local: providers/uploads/local.md
+  - Integrations:
+    - CTFtime: integrations/ctftime.md
+  - Development:
+    - Manual installation: development/manual-installation.md
+
 repo_name: GitHub
 repo_url: https://github.com/redpwn/rctf
 edit_uri: blob/master/docs/content/