Wiki gardeners

(Weeding)
m (Protected "Wiki gardeners" [edit=autoconfirmed:move=autoconfirmed])
 
(25 intermediate revisions not shown)
Line 1: Line 1:
-
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.
+
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.
-
Its current mission is to be a centralized organization point for all [[Main Page|Maemo wiki]] related improvement efforts.
+
Our current mission is to be a centralized organization point for all [[Main Page|Maemo wiki]] related improvement efforts.
-
Right now, the primary goal of this group is to ensure that we maintain a good editorial standard for content which gets added to the wiki, that the organisation and linking of the articles on the wiki is coherent, and that generally, the wiki is a nice place for Maemo users and developers to come to find information.
+
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.
-
== Maemo Wiki Principles ==
+
For general guidelines on editing wiki pages, please read [[contributing to the wiki]].
-
* 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 can 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.
+
-
* Link to relevant content rather than copy it into the wiki.
+
-
== Tasks ==
+
In addition:
-
This is a summary of the group's current tasks. This list will evolve over time.
+
* 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.
-
* Get the word out.
+
== Tasks ==
-
* Bring in people to help with the group's projects and begin defining task forces with certain realms of responsibility.
+
This is a summary of the group's current tasks and TODO list. This list will evolve over time.
=== Pruning ===
=== Pruning ===
-
* Edit old pages to update them for [[Fremantle]]
+
* Edit old pages to update them for [[Open development/Maemo roadmap/Fremantle|Fremantle]] and Harmattan
-
* Start grouping Diablo and Brora information together behind version-specific sections, to clean up primary navigation path for visitors
+
* Start grouping [[Open development/Maemo roadmap/Diablo|Diablo]] and Bora 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
+
* 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
=== Weeding ===
=== Weeding ===
-
* Identify duplicate or redundant pages, and merge them
+
* 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
-
* Create a list of pages here which people can merge if they have a few minutes
+
* Create a list of pages which people can merge if they have a few minutes
-
** [[Companies in Maemo development]] and [[Maemo professionals]] (same thing)
+
** [[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.
** [[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.
-
** [[Maemo5 101]], [[Maemo For Beginners]], [[Os2008 101]], and possibly [[customizing Maemo]]
+
** [[Maemo5 101]], [[Maemo For Beginners]], [[Os2008 101]]
-
** [[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") - DONE
+
** [http://wiki.maemo.org/index.php?title=Special%3APrefixindex&from=N900+Hardware&namespace=0 N900 Hardware* pages]
-
** [[Questions and answers]], [[Frequently asked questions]], [[N900 FAQ]], [[Troubleshooting]] - these should be merged to a user FAQ (with the name "Frequently Asked Questions") - DONE
+
 
-
** See [[Task:Consolidation of Extras]] for a list of pages related to building, packaging & distributing packages which need consolidation.
+
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 ===
=== 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.
* 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)
+
* 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.
+
* 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:
Candidates for merging or organising under a hierarchy:
-
* Everything to do with the organisation of [[maemo.org team | maemo.org staff]] - [[Maemo.org Sprints | sprints]], roles, bios
 
* 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, ...
* 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]
* 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]
-
* Mer - they're in pretty good shape already, but should move from "Hot topics" to "Community" or "Developers", I think.
 
-
* [[Community Council]] - governance, role, election material, rules, news, etc
 
* Summer of Code participation - past participations, link to project pages, description of who's who (admins, students), collect reports on completed projects...
* 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 ===
=== Planting ===
* See [[Documentation wishlist]]
* 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 69: Line 74:
* Create [[Special:Wantedpages|wanted pages]], even as ''stubs''
* Create [[Special:Wantedpages|wanted pages]], even as ''stubs''
* Fix [[Special:Doubleredirects|double redirects]]
* Fix [[Special:Doubleredirects|double redirects]]
-
* Add links to [[Special:Deadendpages]]
+
* Add links to [[Special:Lonelypages | orphan pages]]
* And more...
* 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 95: Line 100:
# [[User:pepitoe|pepitoe]] January 2010
# [[User:pepitoe|pepitoe]] January 2010
# [[User:pgrodt|pgrodt]] 19:36, 12 January 2010 (UTC)
# [[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