User Tools

Site Tools


wiki_contribution_guidelines

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Last revisionBoth sides next revision
wiki_contribution_guidelines [2018/12/08 23:31] – created puffinuxwiki_contribution_guidelines [2018/12/14 22:41] puffinux
Line 1: Line 1:
 ====== Wiki contribution guidelines ====== ====== Wiki contribution guidelines ======
-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' way so stuff just slots together and it's not messy. 
  
-This page is work in progress, I'll add stuff here as I decide on it / as I work out what works best.+ 
 +//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 [[wiki:syntax|syntax]] page for general information on how to write in [[https://en.wikipedia.org/wiki/Markdown|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 ===== ===== Creating pages =====
Line 10: Line 15:
 ===== Content in pages ===== ===== Content in pages =====
  
-Pages start with their name--- this page is called wiki_contribution_guidelines, and the header reflects this. Use "======" (H1, six equals signs) size headers. Further headers are smaller (one size below the parents header)+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 breaking topics up in pages (H2 level headers), place a bar (----) above the header, expect above the first H2 header when there is no text between it and the page header (the H1).+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 stick to the methods you already see in place! :-)+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! :-)