Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
wiki:wiki-editing-practices [2023/03/01 02:42] – [Good Wiki Editing Practices] Snarky farewell :-) maximumentropywiki:wiki-editing-practices [2024/07/10 02:55] (current) – [Managing the sidebar] it is not automatically linked (anymore) atari
Line 18: Line 18:
   * Can the page be put into a relevant sub-category? For example, something purely related to a single system should be appended to its relevant [[:systems|system page]].   * Can the page be put into a relevant sub-category? For example, something purely related to a single system should be appended to its relevant [[:systems|system page]].
   * Is the information somewhere else already, and if so, is it in the correct place?   * Is the information somewhere else already, and if so, is it in the correct place?
-  * Ultimately, //something// is better than **nothing**. Even if the information is not robust or high quality enough for the wiki, it's better than a complete absence of it. It can always be revisited to be amended later. The playground can be used if help is needed with certain edits (FIXME specifically which edits?), without going straight to publication.+  * Ultimately, //something// is better than **nothing**. Even if the information is not robust or high quality enough for the wiki, it's better than a complete absence of it. It can always be revisited to be amended later. The playground can be used if help is needed with certain edits, without going straight to publication.
  
 Once that's all checked for, you can begin editing the wiki. Once that's all checked for, you can begin editing the wiki.
Line 103: Line 103:
 If you've created a new page, the next job is to add a link to it to [[:sidebar|the sidebar page]]. You edit this page just like you would any other page. If you've created a new page, the next job is to add a link to it to [[:sidebar|the sidebar page]]. You edit this page just like you would any other page.
  
-  * When considering which category to put it under, avoid adding anything to **Getting Started**. Put it in the category you believe would be the one a new user would use to find the information on your page. If adding a new system page in particular, it will be automatically linked in the [[:systems|systems overview page]] (as long as you've used the correct shortname) and doesn't need to be manually added.+  * When considering which category to put it under, avoid adding anything to **Getting Started**. Put it in the category you believe would be the one a new user would use to find the information on your page. If adding a new system page in particular, link it in the [[:systems|systems overview page]] instead of the sidebar.
   * Pages linked to in the sidebar should use [[:batocera_wiki_code_snippets#in-links|internal links]] with the page's proper name as the display text. The page's proper name should use regular capitalization rules, not Camel Case like the page title is on the page itself.   * Pages linked to in the sidebar should use [[:batocera_wiki_code_snippets#in-links|internal links]] with the page's proper name as the display text. The page's proper name should use regular capitalization rules, not Camel Case like the page title is on the page itself.
   * New pages should also be added to the appropriate section in the [[:navigation|navigation page]] along with a laconic description (if applicable). This is to assist those new to the wiki navigating to the appropriate page.   * New pages should also be added to the appropriate section in the [[:navigation|navigation page]] along with a laconic description (if applicable). This is to assist those new to the wiki navigating to the appropriate page.
  • wiki/wiki-editing-practices.1677638544.txt.gz
  • Last modified: 3 years ago
  • by maximumentropy