Wiki gardeners

(Actually revert it)
m (Protected "Wiki gardeners" [edit=autoconfirmed:move=autoconfirmed])
 
(57 intermediate revisions not shown)
Line 1: Line 1:
-
This group is intended to act as a focusing point for, in the immediate term, the [http://maemo.org/community/wiki/wikireorg/ midgard wiki to mediawiki migration] and, in the long term, as a centralized organization point for all [[Main Page|maemowiki]]-related improvement efforts.
+
The '''Wiki Gardeners''' (previously the Maemowiki Action Group) was originally founded as a focusing point for the migration and editing of content from an older wiki to this one. Our job is to fight the entropy, to keep order in a wild, wild world. A lot like gardening.
-
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.
+
Our current mission is to be a centralized organization point for all [[Main Page|Maemo wiki]] related improvement efforts.
 +
 
 +
Our primary goal is to ensure that we make sure that the wiki is a nice place for Maemo users and developers to come to find and share information.
 +
 
 +
For general guidelines on editing wiki pages, please read [[contributing to the wiki]].
 +
 
 +
In addition:
 +
* 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.
 +
* Pages should be split or consolidated to ensure that they are neither too long or too short.
 +
* Synthesize collections of content in the wiki, but link to relevant articles or official documentation, rather than copying them into the wiki.
== 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 and TODO list. This list will evolve over time.
-
* Get the word out.
+
=== Pruning ===
-
* Bring in people to help with the group's projects and begin defining task forces with certain realms of responsibility.
+
-
=== Midgard migration ===
+
* Edit old pages to update them for [[Open development/Maemo roadmap/Fremantle|Fremantle]] and Harmattan
-
* Migrate old wiki pages to the new wiki, according to http://maemo.org/community/wiki/wikireorg/
+
* Start grouping [[Open development/Maemo roadmap/Diablo|Diablo]] and Bora information together behind version-specific sections, to clean up primary navigation path for visitors
-
* [[MAG:Categorization#Proposed categories|Categorise them]].
+
* Identify pages with information that could be organized differently, rewritten or edited, and open bugs for the changes against [https://bugs.maemo.org/enter_bug.cgi?product=Tutorials&component=maemo.org%20wiki the Tutorials] product in Bugzilla, with the Wiki component
-
* 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 ====
+
=== Weeding ===
-
* 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").
+
* Identify duplicate or redundant pages, and merge them or create bugs about the pages against [https://bugs.maemo.org/enter_bug.cgi?product=Tutorials&component=maemo.org%20wiki the Tutorials] product in Bugzilla, with the Wiki component
-
* 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).
+
* Create a list of pages which people can merge if they have a few minutes
-
* 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.
+
** [[Networking (Diablo)]], [[USB networking]], [[Bluetooth PAN]], [[Bluetooth DUN]], [[USB to ethernet networking]] - suggest merging to a new [[Networking]] article or folding [[Networking (Diablo)]] into the USB and Bluetooth articles.
-
* 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.
+
** [[Maemo5 101]], [[Maemo For Beginners]], [[Os2008 101]]
-
--[[User:dneary|dneary]] 20:19, 5 June 2008 (UTC)
+
** [http://wiki.maemo.org/index.php?title=Special%3APrefixindex&from=N900+Hardware&namespace=0 N900 Hardware* pages]
 +
 
 +
Done:
 +
* [[Developer_FAQ#Maemo_SDK_and_Scratchbox|Q&A - SDK and Scratchbox]], [[Q&A Porting to Fremantle]] and [[Autobuilder FAQ]] - I suggest merging these to a developer FAQ (name "Developer Frequently Asked Questions", and a redirect from "Developer FAQ")
 +
* [[Companies in Maemo development]] and [[Maemo professionals]] (same thing)
 +
* [[Questions and answers]], [[Frequently asked questions]], [[N900 FAQ]], [[Troubleshooting]] - these should be merged to a user FAQ (with the name "Frequently Asked Questions")
 +
* [[Customizing Maemo]], [[customizing maemo for power users]] and [[how to personalize your N900]]
 +
* See [[Task:Consolidation of Extras]] for a list of pages related to building, packaging & distributing packages which have been consolidated.
 +
 
 +
=== 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 more visible & better organised (Sprints, Mer, etc)
 +
* Ensure that all [[Special:Lonelypages | orphaned pages]] are linked from somewhere or deleted (articles can be [[Template:Delete|marked for deletion with a template]]). As a guideline, under 20 orphan pages is a good place to be.
 +
 
 +
Candidates for merging or organising under a hierarchy:
 +
 
 +
* New users pages, including [[Maemo basics]], [[Questions and answers]], [[Frequently asked questions]], setting up an email account, and so on. Basic subjects gathered under here would be thinks like getting started with the N810 and N900, migrating old data to new devices, simple stuff like playing media, typing special characters, user interface quirks, using wifi in universities, ...
 +
* Project roadmap - bringing together [[100Days | the 100 days initiative]], [[2010 Agenda | the 2010 agenda]], [http://wiki.maemo.org/Special:Search?search=Objective%3A&go=Go Objectives] and [http://wiki.maemo.org/Special:Search?search=Task%3A&go=Go Tasks]
 +
* Summer of Code participation - past participations, link to project pages, description of who's who (admins, students), collect reports on completed projects...
 +
 
 +
DONE:
 +
* Everything to do with the organisation of [[maemo.org team | maemo.org staff]] - [[Maemo.org Sprints | sprints]], roles, bios
 +
* Mer - in pretty good shape now
 +
* [[Community Council]] - governance, role, election material, rules, news, etc
 +
 
 +
=== Planting ===
 +
* See [[Documentation wishlist]]
 +
* Add documentation from external resources, such as [http://talk.maemo.org talk.maemo.org]
 +
** Use the [[Template:Wikify|wikify template]] to tag articles with a link to information outside the wiki, like so:<br /><pre>{{wikify|1=<nowiki>http://talk.maemo.org/showthread.php?t=51053}}</nowiki></pre> and replace the URL with the URL of the documentation. Do not forget to leave the ’1=‘!
=== Templates ===
=== Templates ===
Line 33: Line 66:
=== 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 ===
+
=== Other ===
-
* Put together a framework for the front page that is pretty, easy to use, and easy to modify.
+
Check maintenance stuff in [[Special:Specialpages]]:
-
* 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.
+
* Create [[Special:Wantedpages|wanted pages]], even as ''stubs''
 +
* Fix [[Special:Doubleredirects|double redirects]]
 +
* Add links to [[Special:Lonelypages | orphan pages]]
 +
* And more...
== Members ==
== Members ==
-
New members should simply add their name to the bottom of the list and jump right into the project.
+
New members should simply add their name to the bottom of the list and jump right into the project. We strongly suggest following the wiki@documentation.maemo.bugs user in Bugzilla to be notified of all change to wiki content related bugs.
# [[User:generalantilles|generalantilles]] 21:41, 2 June 2008 (UTC)
# [[User:generalantilles|generalantilles]] 21:41, 2 June 2008 (UTC)
Line 54: Line 90:
# [[User:crashanddie| Sebastian Lauwers]] 00:32, 13 September 2008 (UTC)
# [[User:crashanddie| Sebastian Lauwers]] 00:32, 13 September 2008 (UTC)
# [[User:qole|Qole]] June 2009
# [[User:qole|Qole]] June 2009
 +
# [[User:texrat|Randall Arnold]] 19:24, 14 October 2009 (UTC)
 +
# [[User:kaithomsen|Kai Thomsen]] 19:36, 14 October 2009 (UTC)
 +
# [[User:twaelti|Tom "tom2" Waelti]] 20:20, 14 October 2009 (UTC)
 +
# [[User:guaka|guaka]] 10:40, 26 October 2009 (UTC)
 +
# [[User:allnameswereout|allnameswereout]] 14:03, 29 October 2009 (UTC)
 +
# [[User:smarsh|smarsh]] 15:39, 6 November 2009 (UTC)
 +
# [[User:ossipena|ossipena]] 20:04, 9 November 2009 (UTC)
 +
# [[User:YoDude|YoDude]] December 2009
 +
# [[User:pepitoe|pepitoe]] January 2010
 +
# [[User:pgrodt|pgrodt]] 19:36, 12 January 2010 (UTC)
 +
# [[User:renegadefanboy|renegadefanboy]] 17 February 2010 (UTC)
 +
# [[USER:jukey|Uwe Kaminski]] May 2010
 +
# [[USER:chomar|ChoMar]] May 2010
 +
[[Category:Community]]
[[Category:Community]]

Latest revision as of 12:33, 10 May 2012

The Wiki Gardeners (previously the Maemowiki Action Group) was originally founded as a focusing point for the migration and editing of content from an older wiki to this one. Our job is to fight the entropy, to keep order in a wild, wild world. A lot like gardening.

Our current mission is to be a centralized organization point for all Maemo wiki related improvement efforts.

Our primary goal is to ensure that we make sure that the wiki is a nice place for Maemo users and developers to come to find and share information.

For general guidelines on editing wiki pages, please read contributing to the wiki.

In addition:

  • 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.
  • Pages should be split or consolidated to ensure that they are neither too long or too short.
  • Synthesize collections of content in the wiki, but link to relevant articles or official documentation, rather than copying them into the wiki.

Contents

Tasks

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

Pruning

  • Edit old pages to update them for Fremantle and Harmattan
  • Start grouping Diablo and Bora information together behind version-specific sections, to clean up primary navigation path for visitors
  • Identify pages with information that could be organized differently, rewritten or edited, and open bugs for the changes against the Tutorials product in Bugzilla, with the Wiki component

Weeding

Done:

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 more visible & better organised (Sprints, Mer, etc)
  • Ensure that all orphaned pages are linked from somewhere or deleted (articles can be marked for deletion with a template). As a guideline, under 20 orphan pages is a good place to be.

Candidates for merging or organising under a hierarchy:

  • New users pages, including Maemo basics, Questions and answers, Frequently asked questions, setting up an email account, and so on. Basic subjects gathered under here would be thinks like getting started with the N810 and N900, migrating old data to new devices, simple stuff like playing media, typing special characters, user interface quirks, using wifi in universities, ...
  • Project roadmap - bringing together the 100 days initiative, the 2010 agenda, Objectives and Tasks
  • Summer of Code participation - past participations, link to project pages, description of who's who (admins, students), collect reports on completed projects...

DONE:

Planting

  • See Documentation wishlist
  • Add documentation from external resources, such as talk.maemo.org
    • Use the wikify template to tag articles with a link to information outside the wiki, like so:
      {{wikify|1=http://talk.maemo.org/showthread.php?t=51053}}
      and replace the URL with the URL of the documentation. Do not forget to leave the ’1=‘!

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.

Other

Check maintenance stuff in Special:Specialpages:

Members

New members should simply add their name to the bottom of the list and jump right into the project. We strongly suggest following the wiki@documentation.maemo.bugs user in Bugzilla to be notified of all change to wiki content related bugs.

  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
  11. Randall Arnold 19:24, 14 October 2009 (UTC)
  12. Kai Thomsen 19:36, 14 October 2009 (UTC)
  13. Tom "tom2" Waelti 20:20, 14 October 2009 (UTC)
  14. guaka 10:40, 26 October 2009 (UTC)
  15. allnameswereout 14:03, 29 October 2009 (UTC)
  16. smarsh 15:39, 6 November 2009 (UTC)
  17. ossipena 20:04, 9 November 2009 (UTC)
  18. YoDude December 2009
  19. pepitoe January 2010
  20. pgrodt 19:36, 12 January 2010 (UTC)
  21. renegadefanboy 17 February 2010 (UTC)
  22. Uwe Kaminski May 2010
  23. ChoMar May 2010
Retrieved from "http://bugs.maemo.org/Wiki_gardeners"