From d518b05a8667943bd0aa9ab1edc91eec0a8283fe Mon Sep 17 00:00:00 2001
From: Eric Eastwood <erice@element.io>
Date: Thu, 22 Jul 2021 05:58:24 -0500
Subject: [PATCH] Move dev/ docs to development/ (#10453)

---
 CONTRIBUTING.md                                |   2 +-
 changelog.d/10453.doc                          |   1 +
 docs/SUMMARY.md                                |   6 +++---
 docs/{dev => development}/cas.md               |   0
 docs/{dev => development}/git.md               |   6 +++---
 docs/{dev => development/img}/git/branches.jpg | Bin
 docs/{dev => development/img}/git/clean.png    | Bin
 docs/{dev => development/img}/git/squash.png   | Bin
 docs/{dev => development}/saml.md              |   0
 9 files changed, 8 insertions(+), 7 deletions(-)
 create mode 100644 changelog.d/10453.doc
 rename docs/{dev => development}/cas.md (100%)
 rename docs/{dev => development}/git.md (97%)
 rename docs/{dev => development/img}/git/branches.jpg (100%)
 rename docs/{dev => development/img}/git/clean.png (100%)
 rename docs/{dev => development/img}/git/squash.png (100%)
 rename docs/{dev => development}/saml.md (100%)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a4e6688042..80ef6aa235 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -392,7 +392,7 @@ By now, you know the drill!
 # Notes for maintainers on merging PRs etc
 
 There are some notes for those with commit access to the project on how we
-manage git [here](docs/dev/git.md).
+manage git [here](docs/development/git.md).
 
 # Conclusion
 
diff --git a/changelog.d/10453.doc b/changelog.d/10453.doc
new file mode 100644
index 0000000000..5d4db9bca2
--- /dev/null
+++ b/changelog.d/10453.doc
@@ -0,0 +1 @@
+Consolidate development documentation to `docs/development/`.
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index db4ef1a44e..f1bde91420 100644
--- a/docs/SUMMARY.md
+++ b/docs/SUMMARY.md
@@ -67,7 +67,7 @@
 # Development
   - [Contributing Guide](development/contributing_guide.md)
   - [Code Style](code_style.md)
-  - [Git Usage](dev/git.md)
+  - [Git Usage](development/git.md)
   - [Testing]()
   - [OpenTracing](opentracing.md)
   - [Database Schemas](development/database_schema.md)
@@ -77,8 +77,8 @@
     - [TCP Replication](tcp_replication.md)
   - [Internal Documentation](development/internal_documentation/README.md)
     - [Single Sign-On]()
-      - [SAML](dev/saml.md)
-      - [CAS](dev/cas.md)
+      - [SAML](development/saml.md)
+      - [CAS](development/cas.md)
     - [State Resolution]()
       - [The Auth Chain Difference Algorithm](auth_chain_difference_algorithm.md)
     - [Media Repository](media_repository.md)
diff --git a/docs/dev/cas.md b/docs/development/cas.md
similarity index 100%
rename from docs/dev/cas.md
rename to docs/development/cas.md
diff --git a/docs/dev/git.md b/docs/development/git.md
similarity index 97%
rename from docs/dev/git.md
rename to docs/development/git.md
index 87950f07b2..9b1ed54b65 100644
--- a/docs/dev/git.md
+++ b/docs/development/git.md
@@ -9,7 +9,7 @@ commits each of which contains a single change building on what came
 before. Here, by way of an arbitrary example, is the top of `git log --graph
 b2dba0607`:
 
-<img src="git/clean.png" alt="clean git graph" width="500px">
+<img src="img/git/clean.png" alt="clean git graph" width="500px">
 
 Note how the commit comment explains clearly what is changing and why. Also
 note the *absence* of merge commits, as well as the absence of commits called
@@ -61,7 +61,7 @@ Ok, so that's what we'd like to achieve. How do we achieve it?
 The TL;DR is: when you come to merge a pull request, you *probably* want to
 “squash and merge”:
 
-![squash and merge](git/squash.png).
+![squash and merge](img/git/squash.png).
 
 (This applies whether you are merging your own PR, or that of another
 contributor.)
@@ -105,7 +105,7 @@ complicated. Here's how we do it.
 
 Let's start with a picture:
 
-![branching model](git/branches.jpg)
+![branching model](img/git/branches.jpg)
 
 It looks complicated, but it's really not. There's one basic rule: *anyone* is
 free to merge from *any* more-stable branch to *any* less-stable branch at
diff --git a/docs/dev/git/branches.jpg b/docs/development/img/git/branches.jpg
similarity index 100%
rename from docs/dev/git/branches.jpg
rename to docs/development/img/git/branches.jpg
diff --git a/docs/dev/git/clean.png b/docs/development/img/git/clean.png
similarity index 100%
rename from docs/dev/git/clean.png
rename to docs/development/img/git/clean.png
diff --git a/docs/dev/git/squash.png b/docs/development/img/git/squash.png
similarity index 100%
rename from docs/dev/git/squash.png
rename to docs/development/img/git/squash.png
diff --git a/docs/dev/saml.md b/docs/development/saml.md
similarity index 100%
rename from docs/dev/saml.md
rename to docs/development/saml.md
-- 
GitLab