aaand again

[xonotic/xonotic.wiki.git] / Editing.md

diff --git a/Editing.md b/Editing.md
index 64eacd6bab146a4a7028569e4218a636eca65fa2..6daf6d347eb5ccdd3bf3ea383161ee607144cde6 100644 (file)
--- a/Editing.md
+++ b/Editing.md
@@ -1,4 +1,4 @@
-If you want write access, please ask for it at [#xonotic on FreeNode](https://webchat.freenode.net/), we'll gladly give it to you. There is no way to allow anonymous editing on GitLab.
+If you want write access, please ask for it at [#xonotic on FreeNode](https://webchat.freenode.net/), we'll gladly give it to you. There is no way to allow anonymous editing on GitLab. After that, you can edit the wiki online (there is an Edit button when logged in) or clone it to your machine using git.
 
 The official version is on [GitLab](https://gitlab.com/xonotic/xonotic/wikis/home) but we also sync the wiki to [GitHub](https://github.com/xonotic/xonotic/wiki). Please, follow this guide when editing to make sure everything works properly on both.
 
@@ -12,7 +12,7 @@ Interestingly, spaces in filenames and links seem to work fine for both GitHub a
 Subdirectories
 --------------
 
-It's ok (and preferred) to put images and other assets into subdirectories but we have to **put pages (the `.md` files) in root** becuase GitHub doesn't support subdirs properly (it flattens everything - this can cause collisions, plus there is no way to link from subdir to another subdir that works on both GitLab and GitHub).
+It's ok (and preferred) to put images and other assets into subdirectories but we have to **put pages in root** becuase GitHub doesn't support subdirs properly (it flattens everything - this can cause collisions, plus there is no way to link from subdir to another subdir that works on both GitLab and GitHub).
 
 Links to pages
 -------------
@@ -22,3 +22,8 @@ Use standard markdown links: `[Text](link)` (e.g. `[Back to main page](Home)` to
  - Don't prefix `link` with either `../link` or `/link` - both break on GitHub. Using `./link` seems to work ok but is unnecessary since we have to put everything in root anyway.
 
 Links don't seem to be case sensitive but it's probably best to use proper capitalization just in case it breaks in some edge case somewhere. Also, spaces and dashes seem to be freely interchangeable on GH and GL but again, probably best to use dashes.
+
+Automated checking
+-------------------
+
+Neither GL not GH support red links (highlighting broken links) so there's a script in [`assets/check-and-fix.py`](assets/check-and-fix.py) that finds broken links and unreachable files. To use it, clone the wiki and run the script in its root. It can also automatically move or rename files that don't follow the above guidelines if you run it with `--fix`.