User Tools

Site Tools


wiki_contribution_guidelines

This is an old revision of the document!


Wiki contribution guidelines

This page is work in progress, I'll add stuff here as I decide on it / as I work out what works best.

These are guidelines for how to contribute to the wiki in a way that is most efficient and effective, without causing more work for the admin, who's fussy and particular :-D. I get that we're all anarchists and whatnot, but it makes sense to have a method to adding content to the wiki in a “standard-ish” way so stuff just slots together and it's not messy and disorganised.

Please see the syntax page for general information on how to write in Markdown. This is the 'language' used in the wiki plain text files to make them render as HTML with bold, italics, headers, links etc.


Creating pages

If a page doesn't exist that you feel would be useful or is required, then search for it even though it doesn't exist (search for the specific name you want the page to be called i.e. in its url) and then click the name in the search blurb to open the edit page for the new file. Once saved, make sure you add it to the Sidebar page if it's something that should go there (i.e. not just a quick note on what the fediverse is, for example).

Content in pages

Pages start with their name in a header— this page is called wiki_contribution_guidelines, and the first header reflects this. Use “======” (H1) size headers. Further headers are smaller “=====” (H2) and their respective headers are one size smaller again. Keep to this logic and you shouldn't go wrong.

When changing topics in pages (using H2 level headers and changing focus / subject), place a horizontal rule above the header, except above the first H2 header in the page, when there is no text between it and the page header (the H1).


Try to keep things tidy, and, if you see a method in place for contributing your content you would like to add, try to stick to it! :-)

wiki_contribution_guidelines.1544827203.txt.gz · Last modified: 2018/12/14 22:40 by puffinux