mirror of
https://github.com/SysRay/psOff_public.git
synced 2024-11-30 01:50:24 +00:00
.. | ||
json | ||
resource | ||
uml/modules | ||
wiki | ||
README.md |
Docs README
Wiki update rules
General rules
- You should not put anything to root wiki directory (
docs/wiki/
); - All the
.md
files should go todocs/wiki/markdown/
folder; - Your links should not lead to shady sites;
- If you removed screenshot from the markdown code then delete the image itself in the
docs/wiki/markdown/images/
folder.
Name your wiki files properly!
- Do not use the following characters in your wiki page's titles:
\ / : * ? " < > |
; - Use
-
sign instead of space; - Too long name is not good at all, keep it ~32 chars long maximum;
- It's cool that GitHub's markup engine supports so much markup languages, but keep it
md
for consistency, please. Markdowns are the easiest to maintain and most common pretty everywhere; - You should write wiki pages only in English. We also do not accept translated pages there since GitHub does not support them. The wiki would be a mess if we did accept these changes.
Add screenshots if needed!
- Don't do it too often;
- Add screenshots that will actually help;
- Draw eye directing arrows or circles of some kind on them, if possible and necessary;
- Screenshots should be uploaded to this repository only, there are special folder for these:
docs/wiki/images/
, just use relative`/docs/wiki/images/image.png`
links to add them in your markdown page; - Give your screenshots meaningful file names and put them in sub-directories so they don't get lost.