Difference between revisions of "Wiki gardening"

From Open Food Facts wiki
Jump to navigation Jump to search
(First version)
 
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
[[File:Puzzle-orange.png|thumb]]
 +
 +
 
Open Food Facts wiki is dedicated to documentation and knowledge sharing. It can be also used for project information or other usages.
 
Open Food Facts wiki is dedicated to documentation and knowledge sharing. It can be also used for project information or other usages.
  
== What? ==
+
=== What ===
 
Wiki gardening is a way to maintain the wiki up to date and efficient.
 
Wiki gardening is a way to maintain the wiki up to date and efficient.
  
== Why? ==
+
=== Why ===
 
* The wiki helps people to better contribute to Open Food Facts.
 
* The wiki helps people to better contribute to Open Food Facts.
 
* The wiki needs to present things that are not (still) well explained on Open Food Facts websites or tools.
 
* The wiki needs to present things that are not (still) well explained on Open Food Facts websites or tools.
 
* If the wiki is not presentable, it loses credibility.
 
* If the wiki is not presentable, it loses credibility.
  
== Tasks ==
+
=== Needs / Missions 🏗️ ===
 
* Rewrite and refactor to improve readability:
 
* Rewrite and refactor to improve readability:
 
** typos, misspellings, ...
 
** typos, misspellings, ...
 
** rearrange pages, split long pages into smaller ones, delete pages
 
** rearrange pages, split long pages into smaller ones, delete pages
 +
** add intro to pages to give context, make links between pages
 +
** make it easier for newcomers to find what they are searching for. Information most useful to a large number, should be simple to access from the front page.
 
* Categorize pages, to allow exploring things by categories
 
* Categorize pages, to allow exploring things by categories
* Ensure information is up-to-date [use a category to identify perished contents]
+
* Update content that need to be: see [[:Category:To be updated|Category:To be updated]]
 +
* Ensure information is up-to-date: use the [[:Category:To be updated|Category:To be updated]] to identify contents that need to be
 +
* make wiki nicer (tip: use [[Wiki Icons]])
 +
 
 +
=== Tools ⚒️ ===
 +
 
 +
* Pages listed in [[Special:SpecialPages]]:
 +
** [[Special:LongPages|Long pages]]
 +
** [[Special:ShortPages|Short pages]]
 +
** [[Special:OrphanedPages|Orphaned pages]]
 +
** [...]
 +
* [[Wiki Icons]]
 +
 
 +
=== Connecting with other members ===
 +
* On the following [https://slack.openfoodfacts.org/ Slack] channels:
 +
** [https://openfoodfacts.slack.com/archives/C0LJ38C6M #wiki-gardening]
 +
 
 +
=== 🎯 Roadmap ===
 +
* Install quality of life [[Wiki extensions]]
 +
* Enable SSO once openfoodfacts-auth is deployed
 +
* Install & config the new modern theme, with support for a top bar coherent with the rest of the Open Food Facts website
 +
 
  
== Tools ==
+
[[Category:Teams]]
* [[Special:LongPages|Long pages]]
+
[[Category:Wiki maintenance]]
* [[Special:ShortPages|Short pages]]
 
* [[Special:OrphanedPages|Orphaned pages]]
 

Latest revision as of 23:50, 5 September 2024

Puzzle-orange.png


Open Food Facts wiki is dedicated to documentation and knowledge sharing. It can be also used for project information or other usages.

What

Wiki gardening is a way to maintain the wiki up to date and efficient.

Why

  • The wiki helps people to better contribute to Open Food Facts.
  • The wiki needs to present things that are not (still) well explained on Open Food Facts websites or tools.
  • If the wiki is not presentable, it loses credibility.

Needs / Missions 🏗️

  • Rewrite and refactor to improve readability:
    • typos, misspellings, ...
    • rearrange pages, split long pages into smaller ones, delete pages
    • add intro to pages to give context, make links between pages
    • make it easier for newcomers to find what they are searching for. Information most useful to a large number, should be simple to access from the front page.
  • Categorize pages, to allow exploring things by categories
  • Update content that need to be: see Category:To be updated
  • Ensure information is up-to-date: use the Category:To be updated to identify contents that need to be
  • make wiki nicer (tip: use Wiki Icons)

Tools ⚒️

Connecting with other members

🎯 Roadmap

  • Install quality of life Wiki extensions
  • Enable SSO once openfoodfacts-auth is deployed
  • Install & config the new modern theme, with support for a top bar coherent with the rest of the Open Food Facts website