Update conversion process to include ellipsis, rename changes

Author: zlovatt

docs/updating-legacy-docs/converting-rst-to-md.md

@@ -59,12 +59,19 @@ Once the work is done, submit a PR to merge it into the main branch.
     ```sh
     sphinx-build -M markdown ./docs ./build
     ```
-2. For simplicity, we're going to merge these files from `./build/markdown`/ straight into `./docs/`, so that all of each subfolder's .rst files sit alongside their .md files
-   - Move all files from `./build/markdown/` into `./docs/`
-3. Delete the `./build/` folder, as it won't be needed
-4. Rename `./docs/index.md` to `./docs/_nav.md`
+    - This will generate .md files within `./build/markdown`
+2. We want to replace all of the .rst files with the .md files, *however* if we simply delete the .rst and add the .md we will lose all of the git history!
+   - To get around this, we're going to first *rename* all of the .rst files to .md, and *then* overwrite the "fake" renamed .md files with the converted .md files
+3. Using your renamer tool of choice, rename all .rst files in docs/ to the .md extension
+4. **Commit this rename change!**
+   - Be careful not to commit anything in `./build/`, as we don't want these in the repo (yet)
+5. Now, overwrite all `./docs/` .md files with those from `./build/markdown/`
+6. Delete the `./build/` folder, as it won't be needed
+7. Rename `./docs/index.md` to `./docs/_nav.md`
    - This is a temporary process that we'll resolve later
    - It needs to be rewritten in a different format, and moved into `./mkdocs.yml`, with this file deleted
+8. **Commit this overwrite change!**
+   - This solidifies the history, at which point we can start cleanup
 
 ---
 
@@ -112,6 +119,7 @@ Instead of initializing Mkdocs from scratch, we're going to just copy files over
     - Using regex, search for `“|”` and replace with `"`
     - Using regex, search for `‘|’` and replace with `'`
     - Using regex, search for `–` and replace with `-`
+    - Search for `…` and replace with `...`
 5. Update offset sublist settings
     - Using regex, search for`(\n|\r)  : - ` and replace with `:\n    - ` – only seems to be an issue with changelog