From e2471e4f827c4a2b071835b5eccf69677ec9cf3d Mon Sep 17 00:00:00 2001
From: Lucy Poulton <lucy@lucypoulton.net>
Date: Tue, 28 Feb 2023 16:22:19 +0000
Subject: [PATCH] Write some more docs

---
 .github/workflows/build-docs.yml           | 11 +++--------
 docs/p.tree                                |  1 +
 docs/topics/Config.md                      |  5 -----
 docs/topics/Migrating-from-ProNouns-2-x.md | 17 +++++++++++++++++
 docs/topics/getting-started.md             |  7 +++++++
 5 files changed, 28 insertions(+), 13 deletions(-)
 create mode 100644 docs/topics/Migrating-from-ProNouns-2-x.md

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index a0a216f..94ea3cb 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -3,10 +3,8 @@ name: Build docs
 on:
   push:
     branches: ["main"]
-
   workflow_dispatch:
-  
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+
 permissions:
   contents: read
   pages: write
@@ -19,14 +17,11 @@ env:
 jobs:
   build-job:
     runs-on: ubuntu-latest
-    container: 
-      image: registry.jetbrains.team/p/writerside/builder/writerside-builder:2.1.984
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
-      - run: |  
-          set -e
-          /opt/builder/bin/idea.sh helpbuilderinspect -source-dir ./docs -product $PRODUCT -output-dir artifacts/ || true
+      - name: Build Writerside docs using Docker
+        uses: JetBrains/writerside-github-action@v3
       - name: Upload artifact
         uses: actions/upload-artifact@v3
         with:
diff --git a/docs/p.tree b/docs/p.tree
index dd82eb5..eee8f33 100644
--- a/docs/p.tree
+++ b/docs/p.tree
@@ -10,6 +10,7 @@
     <toc-element topic="getting-started.md">
         <toc-element topic="Boring-nerdy-grammar-stuff.md"/>
         <toc-element topic="Pronoun-set-format.md"/>
+        <toc-element topic="Migrating-from-ProNouns-2-x.md"/>
     </toc-element>
     <toc-element topic="Setting-your-pronouns.md"/>
     <toc-element topic="Config.md"/>
diff --git a/docs/topics/Config.md b/docs/topics/Config.md
index 52a83ac..0a956c9 100644
--- a/docs/topics/Config.md
+++ b/docs/topics/Config.md
@@ -76,8 +76,3 @@ mysql.password
 stats
 : Whether to send anonymous statistics information about the plugin. Defaults to `true`. 
 See [Privacy](Privacy.md) for more information.
-
-# Default config
-```ini
-```
-{src="/pronouns-common/src/main/resources/pronouns-default.cfg"}
diff --git a/docs/topics/Migrating-from-ProNouns-2-x.md b/docs/topics/Migrating-from-ProNouns-2-x.md
new file mode 100644
index 0000000..d822e1e
--- /dev/null
+++ b/docs/topics/Migrating-from-ProNouns-2-x.md
@@ -0,0 +1,17 @@
+# Migrating from ProNouns 2.x
+
+If you're updating from ProNouns 2.x, you'll need to manually migrate your pronoun store. 
+Fortunately this is a very simple process.
+
+
+
+## Before you start
+
+Make sure you've [set up your new pronoun store]](Stores.md) before migrating.
+
+## Migrating
+### If you were using MySQL
+> Migration from a legacy MySQL store is not yet supported.
+
+### If you were __not__ using MySQL
+Run the command `/pronouns migrate yml`.
diff --git a/docs/topics/getting-started.md b/docs/topics/getting-started.md
index d33eaa7..039e161 100644
--- a/docs/topics/getting-started.md
+++ b/docs/topics/getting-started.md
@@ -3,4 +3,11 @@
 Hey! Thanks for choosing to install ProNouns on your server. 
 This site tells you everything you need to know about using the plugin.
 
+
+> THIS IS PRE-RELEASE SOFTWARE!
+> 
+> I assume absolutely no responsibility if this plugin breaks anything - use at your own risk.
+>
+{style="warning"}
+
 This page's subpages contain the most important things you need to know - **read them first!**