Wiki gardeners

(Actually revert it)
(→Tasks)
Line 2: Line 2:
Right now, the primary goal of this group is to assist with cleaning up the fallout of midgard wiki to mediawiki move by putting together a strong framework (templates, categorization, etc) for moving forward with a well organized and useful [[Main Page|maemowiki]], and bringing all of the ex-midgard wikipages up to the higher quality standards of the new mediawiki.
Right now, the primary goal of this group is to assist with cleaning up the fallout of midgard wiki to mediawiki move by putting together a strong framework (templates, categorization, etc) for moving forward with a well organized and useful [[Main Page|maemowiki]], and bringing all of the ex-midgard wikipages up to the higher quality standards of the new mediawiki.
 +
 +
== Maemo Wiki Principles ==
 +
* Page names should be short and to the point. The page name is a label, not a sentence. No more "How to EASILY boot from an MMC Card". "MMC card boot" (or similar) will do.
 +
** Page names should also be capitalized like a sentence instead of a title ("MMC card boot", ''not'' "MMC Card Boot") and should contain spaces ("MMC card boot", ''not'' "MMCCardBoot").
 +
* The front page must remain clean. Each section will have 4 to 5 front-page links, with a category link (hidden behind "More topics") to all of the other pages in the category. We cat use subcategories too, for sections that get cumbersome (personal opinion of cumbersome: more than 20 articles).
 +
* Pages should be split or consolidated so that they are roughly 1 to 2 browser page-lengths long. There's nothing worse than a 3-sentence wiki-page, or a 20-page document.
 +
* We will link to the content outside the wiki which someone browsing to the wiki is likely to want to find.
 +
== Tasks ==
== Tasks ==
-
This is a summary of the group's current tasks. This list will be refined and expanded over the next few weeks as we determine the correct scope and focus, and pound out the details of this work.
+
This is a summary of the group's current tasks. This list will evolve over time.
* Get the word out.
* Get the word out.
* Bring in people to help with the group's projects and begin defining task forces with certain realms of responsibility.
* Bring in people to help with the group's projects and begin defining task forces with certain realms of responsibility.
-
=== Midgard migration ===
+
=== Pruning ===
-
* Migrate old wiki pages to the new wiki, according to http://maemo.org/community/wiki/wikireorg/
+
-
* [[MAG:Categorization#Proposed categories|Categorise them]].
+
-
* Get the old midgard articles up to speed for the mediawiki, style, format and syntax.
+
-
** The articles will hopefully be tagged as former midgard articles during the migration (which will provide us with an auto-generated list similar to the way Wikipedia tags articles as belonging to a particular WikiProject), users should refer to this list for articles that need to be brought up to speed with mediawiki standards.
+
-
** Users should then remove the midgard tag after bringing tagged articles up to speed.
+
-
* Update article content to be relevant for the latest maemo and Internet Tablet OS releases.
+
-
==== Principles guiding the migration ====
+
* Edit old pages to update them for Fremantle
-
* Page names should be short and to the point. The page name is a label, not a sentence. No more "How to EASILY boot from an MMC Card". "MMC card boot" (or similar) will do.
+
* Start grouping Diablo and Brora information together behind version-specific sections, to clean up primary navigation path for visitors
-
** Page names should also be capitalized like a sentence instead of a title ("MMC card boot", ''not'' "MMC Card Boot") and should contain spaces ("MMC card boot", ''not'' "MMCCardBoot").
+
* Identify pages with information that could be organised differently, rewritten or edited
-
* The front page must remain clean. Each section will have 4 to 5 front-page links, with a category link (hidden behind "More topics") to all of the other pages in the category. We cat use subcategories too, for sections that get cumbersome (personal opinion of cumbersome: more than 20 articles).
+
 
-
* Pages should be split or consolidated so that they are roughly 1 to 2 browser page-lengths long. There's nothing worse than a 3-sentence wiki-page, or a 20-page document.
+
=== Weeding ===
-
* I think we should link to the content outside the wiki which someone browsing to the wiki is likely to want to find. That means that for a developer, the first two links should be "An introduction to maemo" and "Porting applications to maemo". Even though these are not wiki documents, and are official docs. Given that there is a plan to move official documentation to the wiki, this seems reasonable to me.
+
 
-
--[[User:dneary|dneary]] 20:19, 5 June 2008 (UTC)
+
* Identify duplicate or redundant pages, and merge them
 +
* Create a list of pages here which people can merge if they have a few minutes
 +
 
 +
=== Landscaping ===
 +
 
 +
* Revisit navigation in wiki for the top 3 levels of links (front page, and pages linked to from front page) to improve discoverability of useful documentation, tutorials and team workspaces.
 +
* Help various teams using wiki for web content to make their content ore visible & better organised (Sprints, Mer, etc)
 +
 
 +
=== Planting ===
 +
* See [[Documentation wishlist]]
=== Templates ===
=== Templates ===
Line 33: Line 44:
=== Categorization ===
=== Categorization ===
{{main|MAG:Categorization}}
{{main|MAG:Categorization}}
-
* Begin defining clear categories for the organization of articles.
+
* Revise categories to aid the organization of articles.
* Place articles into the correct categories.
* Place articles into the correct categories.
-
* Put together an categorical index.
+
* Put together an categorical index with cover content/article.
-
 
+
-
=== Front page ===
+
-
* Put together a framework for the front page that is pretty, easy to use, and easy to modify.
+
-
* Set down a plan for front page maintenance and updating. As it's the most visible part of the website, changes to the front page shouldn't be taken lightly.
+
== Members ==
== Members ==

Revision as of 19:22, 14 October 2009

This group is intended to act as a focusing point for, in the immediate term, the midgard wiki to mediawiki migration and, in the long term, as a centralized organization point for all maemowiki-related improvement efforts.

Right now, the primary goal of this group is to assist with cleaning up the fallout of midgard wiki to mediawiki move by putting together a strong framework (templates, categorization, etc) for moving forward with a well organized and useful maemowiki, and bringing all of the ex-midgard wikipages up to the higher quality standards of the new mediawiki.

Contents

Maemo Wiki Principles

  • Page names should be short and to the point. The page name is a label, not a sentence. No more "How to EASILY boot from an MMC Card". "MMC card boot" (or similar) will do.
    • Page names should also be capitalized like a sentence instead of a title ("MMC card boot", not "MMC Card Boot") and should contain spaces ("MMC card boot", not "MMCCardBoot").
  • The front page must remain clean. Each section will have 4 to 5 front-page links, with a category link (hidden behind "More topics") to all of the other pages in the category. We cat use subcategories too, for sections that get cumbersome (personal opinion of cumbersome: more than 20 articles).
  • Pages should be split or consolidated so that they are roughly 1 to 2 browser page-lengths long. There's nothing worse than a 3-sentence wiki-page, or a 20-page document.
  • We will link to the content outside the wiki which someone browsing to the wiki is likely to want to find.


Tasks

This is a summary of the group's current tasks. This list will evolve over time.

  • Get the word out.
  • Bring in people to help with the group's projects and begin defining task forces with certain realms of responsibility.

Pruning

  • Edit old pages to update them for Fremantle
  • Start grouping Diablo and Brora information together behind version-specific sections, to clean up primary navigation path for visitors
  • Identify pages with information that could be organised differently, rewritten or edited

Weeding

  • Identify duplicate or redundant pages, and merge them
  • Create a list of pages here which people can merge if they have a few minutes

Landscaping

  • Revisit navigation in wiki for the top 3 levels of links (front page, and pages linked to from front page) to improve discoverability of useful documentation, tutorials and team workspaces.
  • Help various teams using wiki for web content to make their content ore visible & better organised (Sprints, Mer, etc)

Planting

Templates

Main article: MAG:Templates

  • Put together a set of templates to assist in the categorization, tagging and expansion of articles, and help maintain a uniform style and format across the wiki.
  • Set up a template reference page.
  • Categorize all templates.

Categorization

Main article: MAG:Categorization

  • Revise categories to aid the organization of articles.
  • Place articles into the correct categories.
  • Put together an categorical index with cover content/article.

Members

New members should simply add their name to the bottom of the list and jump right into the project.

  1. generalantilles 21:41, 2 June 2008 (UTC)
  2. dneary 10:16, 3 June 2008 (UTC)
  3. qgil 19:45, 4 June 2008 (UTC)
  4. lcuk 22:27, 4 June 2008 (UTC)
  5. jaffa 07:09, 5 June 2008 (UTC)
  6. andrewfblack 10:36, 11 June 2008 (UTC)
  7. Baloo 22:26, 19 July 2008 (UTC)
  8. Tim Samoff 02:37, 24 July 2008 (UTC)
  9. Sebastian Lauwers 00:32, 13 September 2008 (UTC)
  10. Qole June 2009
Retrieved from "https://wiki.maemo.org/Wiki_gardeners"