OLPC:Cleanup: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Activity-summary template)
(...)
 
(34 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{wiki-gang}}
{{RightTOC}}
{{RightTOC}}
== Intro ==
As information sprawls across the wiki, we're in constant need of help and efforts to keep it tame, trimmed, and usable - purging old/broken information and links, creating and updating portal pages for various user groups and topics, condensing screenfuls of discussion on talk pages into short, accurate, easy-to-read updates... I'm sure you can think of more.


As information sprawls across the wiki, we're in constant need of help and efforts to keep it tame, trimmed, and usable - purging old/broken information and links, creating and updating portal pages for various user groups and topics... I'm sure you can think of more.
If you'd like to help battle chaos, please join in - just edit pages, no need to ask permission. If you have a request for cleanup, post here. If you've cleaned up a page and want reviews/polishing final touches, post here. Go for it.


If you'd like to help organize knowledge here, please '''jump in and edit'''.
Also see [[:Category:Cleanup]] for pages needing cleanup. Use [[Template:Cleanup]] to mark pages in need of revision by adding the words '''<nowiki>{{Cleanup}}</nowiki>''' to the top of the article.


= Basic cleanup =
=== General wiki text cleanup===
== Getting started ==
Here are some common glitches you can look for when editing:
The first, easiest, and largest tasks on the wiki are ones that anyone can do. Some suggestions:
* Using h1 headings for sections: <tt>=First level heading</tt> = should be <tt>==First level heading==</tt>
* Using http links to wiki pages: <nowiki>http://wiki.laptop.org/go/Wiki_cleanup</nowiki> should be <nowiki>[[Wiki cleanup]]</nowiki>.
* Not using user-friendly wiki links: <nowiki>[[Wiki_cleanup]]</nowiki> should be <nowiki>[[Wiki cleanup]]</nowiki>.
** Some unfriendly links provide alternate text that's not needed once they're made user-friendly: <nowiki>[[Wiki_cleanup|Wiki cleanup]]</nowiki> should be <nowiki>[[Wiki cleanup]]</nowiki>.
* Uncategorized pages.
* Pages with excessive <nowiki><br></nowiki> tags or <nowiki><pre></nowiki> that can be replaced with whitespace.
* Page Titles and Section Headings With Excessive Capitalization: normally just capitalize the first word (but first check "What links here" and/or set up a #REDIRECT).


== Pages needing final touches ==
=== Mark pages that need work ===


There are several thousand pages on this wiki. Many of them were created in a hurry and need to be cleaned up. There is a page here on the wiki that contains a large list of pages that have been marked {{tl|cleanup}}: [[:Category:Cleanup]]. There are two tasks that can be done with this:
* Look over [[:category:drafts]] pages, see if any are quick .

* Go to the [[Special:Allpages]] page, and look for pages that need <nowiki>{{cleanup}}</nowiki> added to them.
* When you find a wiki page that needs cleanup, click the 'Edit' tab and add the <tt><nowiki>{{cleanup}}</nowiki></tt> in the top of the edit box.

=== Mark obsolete pages ===
The wiki has thousands of older pages; you can tell them by dates from before 2007; if you see something that looks like a duplicate or older discussion of a highly-linked page, it may be one of them.

There are special templates that flag such pages more specifically than just "cleanup".
If two pages seem to cover the same ground, figure out the worse page &mdash; the one that's less useful, has less 'What links here', hasn't been ''significantly'' updated recently according to its [History] tab, and has the less obvious title. Mark it either
<nowiki>{{</nowiki>merge|''Better page''}}
or
<nowiki>{{obsolete|link=[[</nowiki>''Better page'']]}}

=== Fix pages that need work ===

It's useful to readers to indicate pages that need work or aren't relevant, but it's far far better to improve or eliminate them.

* Go to the [[:Category:Cleanup]] page and cleanup the pages that you find there using [[wiki markup]].
* Look over [[:category:drafts]] pages, see if any are quick fixes.
* Pick a page from [[:Category:Articles with obsolete information]], [[:Category:Articles to be merged]], or [[:Category:Obsolete]].
** Click 'What links here' and fix those other pages to link to better pages.
** Find obsolete and merge pages, find the better page, make sure it really is better, then move information into the better page.

When you're done and the less good page has nothing relevant and nothing besides old talk pages link to it, remove categories from it and change it to a redirect to the merged page:
<nowiki>#redirect [[New Page Title]]</nowiki>


== Major areas needing attention ==
* Sign-up lists need to go away. People don't actually reply to them when they set up the lists for people to sign up. People who sign up expect to be contacted and they aren't usually.
** [[Educators/Roll_Call]]


== Areas needing attention ==
*Activity-summary template gone wonky
*Activity-summary template gone wonky
**Something strange about [[Books]], but it's not just that page. Something seems to have gone strange with [[:Template:Project-summary]] or [[:Template:Activity-summary]] templates. You can see other examples linked from this page [[:Category:Activity_summary]]. Possibly a move of the template was handled badly.
**Something strange about [[Books]], but it's not just that page. Something seems to have gone strange with [[:Template:Project-summary]] or [[:Template:Activity-summary]] templates. You can see other examples linked from this page [[:Category:Activity_summary]]. Possibly a move of the template was handled badly.

* [[Glossary]] could use some thoughtful expansion. Jargon serves a useful purpose as shorthand for technical discussions, but it also poses a substantial barrier-to-entry for new contributors. A more extensive Glossary would be very helpful in allowing outsiders to become insiders.
* [[Glossary]] could use some thoughtful expansion. Jargon serves a useful purpose as shorthand for technical discussions, but it also poses a substantial barrier-to-entry for new contributors. A more extensive Glossary would be very helpful in allowing outsiders to become insiders.

* [[Accessibility]]
* [[Accessibility]]
* [[Games]]
* [[Games]]
Line 30: Line 54:
* [[Communities]] (including encouraging various communities to get organized enough to make a frontpage, similar to [[Community:Art]])
* [[Communities]] (including encouraging various communities to get organized enough to make a frontpage, similar to [[Community:Art]])
* [[Pilots]]
* [[Pilots]]
* [[Table of Contents]] - Revise or Remove [[User:Katie|Katie]] 10:30, 29 January 2008 (EST)
* [[Table of contents]] - Revise or Remove [[User:Katie|Katie]] 10:30, 29 January 2008 (EST)
** or merge ideas into [[Site map]] (w/ redirect from one to another)
** or merge ideas into [[Site map]] (w/ redirect from one to another)


Line 68: Line 92:
** Some pages cross over, separate into categories
** Some pages cross over, separate into categories


* retire [[Common Rooms]] in favor of the Talk: pages of actual pages
==Clean-up tasks requiring admin privileges==

* merge all the guides and intros to grassroots and community building pages

== Specific projects ==
=== supporting 8.2.0 and earlier releases ===
OLPC wants to support earlier releases for a year (''citation needed''). And earlier [[G1G1 2008]] recipients got 703 ([[8.1.0]]), not spiffy [[8.2.0]].
* Suggest a section "In/for earlier releases"
* use {{tl|consider upgrading}} on pages that describe either 8.2.0 or earlier.
* Come up with consistent language. Suggest
<pre><nowiki>In [[Release notes/8.2.0|Release 8.2.0]] you</nowiki> ''blah blah
blah''<nowiki>

=== In earlier releases ===
In releases prior to [[Release notes/8.2.0|Release 8.2.0]]
(see [[What release am I running?]]) the commands/instructions/ are different</nowiki>
''blah blah
blah''<nowiki>
{{consider upgrading}}</nowiki></pre>
** See [[Home view]] for an example

=== Green/red country & language lists ===
The queries for numbers and status in [[Deployments]] are the final word on what countries are doing what.

The 2007-era complicated framework of colored countries is dated... kill or replace it (see e-mail to wiki-gang mailing list).

=== Activity replication and data ===
Activity versions appear in three or more places
* The Activities/''My name''_(latest) and Activities/''My name''_(8.2) fragments that use {{tl|Activity-oneline}}
* The OBX "badges at the top of wiki pages
* The other, broken {{tl|Activity-summary}}
* The semantic annotation generated by [[Form:Activity]] and {{tl|Activity page}}
Ideally the last can generate all the others.

==== Put semantics on all activities ====

See [[Semantic MediaWiki#For features]] for ways to clean up the above.

Some supporting tasks:
* verify all pages using {{tl|OBX xobundle}} also have [[Property:Activity bundle]], if so kill the badge
** As of 2008-12-10 running [[Activity queries# Old Category:Activity_bundle vs. Property:Activity bundle |a special query]] shows the following activities use {{tl|OBX xobundle}} and thus probably have a .xo file, yet don't have the property (thus aren't using {{tl|Activity page}} or are using it badly:
:: [[Activity Template]], [[Comic Maker]], [[Firefox]], [[Games/Productive]], [[HablarConSara]], [[HelloMesh]], [[Image Viewer]], [[Lambda]], [[OBX proposals]], [[Pacman]], [[Physics]], [[PlayGo]], [[Rollcats]], [[Turtle Art/lang-es]], [[XO-GCC]], [[Xo-get/Xo-get-gtk]], [[XoIRC]]

* Test whether a semantic form's template can be at the top of a page, so that {{tl|Activity page}} can generate badges.
* [[Activity queries]] shows there are many activities without semantic info, so if you query for activities, they are not displayed.

A subset of this is activities that have ...? (unfinished sentence by a semantics lover :)

=== Fix broken external links ===
'' from pywikipediabot's weblinkchecker.py''

*[[Activities/All/lang-es]] links to http://dev.laptop.org/git?p=activity/help - 403 Forbidden.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/en/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/en/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/projects/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/en/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/en/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/en/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/projects/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to http://opteron.9grid.us/olpc/inferno-012808 .xo - 404 Not Found.
*[[Activities/All/lang-es]] links to http://dev.laptop.org/git?p=projects/xoirc-activity - 403 Forbidden.
*[[Activities/All/lang-es]] links to http://dev.laptop.org/git?p=users/dsd/record - 403 Forbidden.
*[[Activities/All/lang-es]] links to https://gforge.inria.fr/frs/download.php/12154/DrGeoII-fast-8.09.xo - HTTP Redirect Loop: [https://gforge.inria.fr/frs/download.php/12154/DrGeoII-fast-8.09.xo] -> [https://gforge.inria.fr/frs/download.php/12154/DrGeoII-fast-8.09.xo].
*[[Activities/All/lang-es]] links to http://dev.laptoptop.org/git?p=activities/model - Socket Error: 'getaddrinfo failed'.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/projects/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/projects/xo_core/ - 404 Not Found.
*[[Activities/All/lang-es]] links to http://gcompris.net/incoming/xo/ - 404 NotFound.
*[[Activities/All/lang-es]] links to http://gcompris.net/incoming/xo/sudoku.activity.xo - 404 Not Found.
*[[Activities/All/lang-es]] links to https://dev.laptop.org/translate/projects/HorseGame/ - 404 Not Found.
*[[Activities/All/lang-es]] links to http://dev.laptop.org/git?p=projects/3dpong - 403 Forbidden.
*[[Activities/All/lang-es]] links to http://dev.laptop.org/git?p=horsegame - 403 Forbidden.
*[[Ask OLPC a Question/lang-ru]] links to http://aaa.opensourcehost.com/~thoughts/faq/ - Socket Error: 'Operation timed out'.
*[[Activities/All/lang-es]] links to http://www.laptop.org/en/laptop/start/activities.shtml - 404 Not Found.
*[[Business]] links to http://wiki.laptop.org/XFCE - 404 Not Found.
*[[Business]] links to http://wiki.laptop.org/opera - 404 Not Found.
*[[Activities/All/lang-es]] links to http://solar.laptop.org:5080/en/xo_bundled/ - Socket Error: 'Operation timed out'.
*[[Activities/All/lang-es]] links to http://solar.laptop.org:5080/en/xo_bundled/ - Socket Error: 'Operation timed out'.
*[[Activities/All/lang-es]] links to http://solar.laptop.org:5080/en/xo_bundled/ - Socket Error: 'Operation timed out'.
*[[Activities/All/lang-es]] links to http://solar.laptop.org:5080/en/xo_bundled/ - Socket Error: 'Operation timed out'.
*[[Activities/All/lang-es]] links to http://solar.laptop.org:5080/en/xo_bundled/ - Socket Error: 'Operation timed out'.
*[[Australia's first deployment]] links to http://schoolserver:5280/admin - Socket Error: 'getaddrinfo failed'.
*[[Australia's first deployment]] links to http://schoolserver/ds-restore - Socket Error: 'getaddrinfo failed'.
*[[Activities/All/lang-es]] links to http://solar.laptop.org:5080/en/xo_bundled/ - Socket Error: 'Operation timed out'.
*[[Australia's first deployment]] links to http://schoolserver:3128 - Socket Error: 'getaddrinfo failed'.
*[[Australia's first deployment]] links to http://schoolserver - Socket Error: 'getaddrinfo failed'.
*[[OLPC Rochester, NY/Event history/26March2008 Workshop]] links to http://wiki.casci.rit.edu/bin/view/Main/LaboratoryForTechnologicalLiteracy - 404 Not Found.
*[[OLPC Rochester, NY/Event history/26March2008 Workshop]] links to http://www.usabilityassociates.com/hfes/index.html - 404 Not Found.
*[[OLPC Rochester, NY/Event history/26March2008 Workshop]] links to http://wiki.casci.rit.edu/bin/view/Main/LaboratoryForTechnologicalLiteracy - 404 Not Found.
*[[OLPC Guatemala]] links to http://www.mineduc.gob.gt/default.asp?seccion=719 - HTTP Redirect Loop: [http://www.mineduc.gob.gt/default.asp?seccion=719] -> [http://www.mineduc.gob.gt/cerrar_sesion.asp] -> [http://www.mineduc.gob.gt/default.asp] -> [http://www.mineduc.gob.gt/cerrar_sesion.asp].

== Tasks requiring an admin ==


*Redirects for deletion
*Redirects for deletion
Line 76: Line 190:
**[http://wiki.laptop.org/go/Category:Pages_for_deletion Pages_for_deletion]
**[http://wiki.laptop.org/go/Category:Pages_for_deletion Pages_for_deletion]


*Work needed on protected pages
**[[Bitfrost]] and [[OLPC Bitfrost]] pages should be merged, see [[Talk:Bitfrost]].This will require the assistance of an admin because OLPC Bitfrost is [http://wiki.laptop.org/index.php?title=Special%3ALog&type=protect&user=&page=OLPC+Bitfrost protected].


== Mission Accomplished ==
*User pages in Main space
Celebrate what we've done.
**[[N1029676%40gmail.com]]

* "XO Giving" and "OLPC groups" merged into [[Regional groups]] (November 2007)
* the weird OlpcProject: "fake namespace" mostly retired" (November 2007)
* Python game stuff cleaned a bit, moved into [[:Category:Developing games]]
* the activity pages that claim to be in the G1G1 activity group in [[Form:Activity]] and [[Template:Activity page] exactly match the activities listed in [[Activities/G1G1/8.2]]. (Some day one might be generated from the other.)


= Advanced wiki organization (merged page) =

== Open tasks ==
Add a lot of this directly to the opentasks template:

<blockquote>
{{opentasks}}
</blockquote>


== Pages desperately needing help ==
* [[Test_Group_Release_Notes]]

== February 2008 barnraising ==

1) Sitemap[s] (good consistent/maintained/watched pages for the public),
- update [[Table of Contents]] and other metapages
- organize a "wiki getting started" section similar to that for the XO; at least in outline
-- longer-term : provide a community site map of contributors and projects

2) Categorize outdated pages, archive long pages
- "needs update" "deprecated" and "archive", "to be avoided"

3) Collections of 'User information' boxes and badges for self-identification of interests and areas where they want to help.
- [[OBX proposals]] (last updated by Xavi and MitchellNCharity)

4) Cleanup of orphans, stubs, and more
- [[OLPC:Cleanup]]
- [[OLPC:Pages for review]] for pages that get <nowiki>{{delete}}</nowiki> and other tags
- [[OLPC:Reviews]] (content review and project review)
- [[OLPC:Features]] (featured collections, activities, projects, and media)
- a stub-sorting/merging/removal campaign
5) Project organization and sorting
- [[:Category:Projects]], [[:Category:Software ideas]], [[:Category:Content ideas]], [[:Category:Hardware ideas]]
---- add a [[:Category:Ideas]] to contain the above?
- make navigation-templates, categorize the above into "ideas" "active projects" "inactive projects" and "in use"
- make page-templates to help people generate new pages more easily (See the top of the [[activities]] page for an example)

6) Category and template organization
- review/prune the category hierarchy
- review Special:Allpages

7) Newbie-welcoming pages
- [[OLPC:welcoming committee]]
- [[OLPC:About]], [[OLPC:Welcome]], a "why make an account" page
- [[Help:Contents]] and links to tutorials
- connection with [[metawikimedia:Help:|meta-wiki]], wikieducator, wikiversity, wikipedia, wikibooks, curriki, and connexions (a bus stop tour?)

== Wiki on-going restructure ==

You can help with cleanup activities by tagging pages for:
* [[:Category:Pages for deletion|Deletion]] as a consequence of a <nowiki>{{delete}}</nowiki> tag. Caveats apply meaning that it '''could''' be deleted - not necessarily that it '''will''' be deleted. A [[:Category:Redirects for deletion|sub-category for deletion]] is specific for #REDIRECT pages tagged with <nowiki>{{deletere}}</nowiki>
* [[:Category:Articles to be merged|Merging]] as a consequence of <nowiki>{{merge}}</nowiki> ''(seeing all those bits-of-pages, siblings could be found to merge with, or other central pages.)''
* [[:Category:Cleanup|Clean-up]] as their current state is sub-standard in some way and needs work.

If you can't find a page, check the:
* [[Special:Log/move|Move log]] - many pages have been moved leaving redirects (that could've been deleted later)
* [[Special:Log/delete|Delete log]] - many things have been deleted...
NOTE: Given the amount of editions (flooding the [[Special:Recentchanges]]) you can parameterize the URL in the navigation bar <tt>http://wiki.laptop.org/index.php?title=Special:Recentchanges&limit=250</tt> changing the <tt>limit</tt> as stated below.

== Restructuring resources ==

The wiki provides the [[Special:Specialpages|Special Pages]] of which the following is an extract that could prove useful.

'''NOTE:''' the built-in [[Special:Search|search]] is a bit spotty in actually finding things. The obvious alternative would be [[Google]] using a site search limited to '''[http://www.google.com/custom?domains=wiki.laptop.org&sitesearch=wiki.laptop.org wiki.laptop.org]''' or just '''[http://www.google.com/custom?domains=laptop.org&sitesearch=laptop.org laptop.org].'''

{|
|-
|[[Special:Longpages|Long pages]]||Long means usually means too much to read - ''note: it doesn't compute embeded pages''
|-
|[[Special:Shortpages|Short pages]]||Empty or stub pages should be reconsidered
|-
|[[Special:Lonelypages|Orphaned pages]]||Unlinked page should fit within the corpus - ''note: it could be categorized''
|-
|[[Special:Deadendpages|Dead-end pages]]||Although valid are also pages that don't invite further exploration of the wiki]]
|-
|}

== Maintenance resources ==

{|
|-
|[[Special:BrokenRedirects|Broken redirects]]||When deleting pages, redirects may have slipped
|-
|[[Special:DoubleRedirects|Double redirects]]||When moving pages, previous redirects don't change
|-
|[[Special:Uncategorizedcategories|Uncategorized categories]]||Categories ''should'' form some kind of hierarchical tree of specialization
|-
|[[Special:Uncategorizedpages|Uncategorized pages]]||Pages ''should'' fit into at least one branch or area discussed in the wiki
|-
|[[Special:Unusedcategories|Unused categories]]||Categories ''should'' have articles to hold on to
|-
|[[Special:Unusedimages|Unused files]]||Files (images and others) ''should'' be linked / used somewhere
|-
|[[Special:Wantedpages|Wanted pages]]||Is a mixed bag, as it includes mispelled links (ie: upper/lower case) together with close-but-not-quite pre-existing pages, and truly wanted pages. Noise here is rather high due to users never having edited their page and many non-existant ''Talk'' pages referenced via templates.
|-
|}

:soon I'll add a bit about the ''special categories'', but in the meantime refer to the ones mentioned above in the ongoing process.


== Ongoing projects, things to note ==

=== Categorization & OLPC boxes ===
''For examples of OLPC box templates in use, see e.g. [[User:Xavi/Test]]
The liberty the wiki provides in creating pages is wonderful, albeit a bit anarchist; particularly if pages are [[Special:Lonelypages|orphaned]] or if they are simple [[Special:Deadendpages|dead-ends]]. Even if they are isolated, [[Special:Categories|categories]] can help. Finally, [http://wiki.laptop.org/index.php?title=Special%3AAllpages&from=&namespace=10 templates] are a way to systematically format data, and possibly categorize pages in some structured way.

Useful [http://wiki.laptop.org/index.php?title=Special%3AAllpages&from=&namespace=10 templates] should be simple to build and to use. As {{tl|Status box}} and {{tl|Educator}} have somewhat proven, their evolution and ability to incorporte both broad and specific details that are relevant and meaningful hasn't been that easy. [[User:Xavi|My conclusion]] is that they will systematically fail until we have a comprehensive and structured understanding of too many things that are currently highly volatile.

The [[OBX proposals|solution proposed]] is a set of [[:Category:OBX templates|''atomic'' templates]] and a way to [[Template:olpcboxtop|group them]] in a visual way. Needless to say that this is not intended to be just a 'visual effect'; the real purpose is to '''''categorize''''' pages so that they can be retrieved. Although the practice is not much different than ''normal categorization'' (ie: making sure the appropriate <tt><nowiki>[[Category:whatever]]</nowiki></tt> appears in the pages) it does provide a more consistent (and easier) way to:
* Provide not only a category, but also some contextual information about it's belonging there
*: For example, a user using the {{tl|user teacher}} box, will end up in the [[:Category:Educators]], the same as another user using the {{tl|user teacher primary}} or {{tl|user teacher university}}, but visually you can tell the difference.
*: If in the future we want to 'split' the categorizations, modifying the appropriate [[:Category:OBX templates|OBX templates]] will result in them being sub-classified based on just the template itself, or maybe some parameter required by it.


Not everything will be nice and comfy with them [[:Category:OBX templates|''olpc boxes'']] but hopefully they will provide the incentive to create simple templates that address a specific need, for example providing links and categorizations in a visually consistent manner so that the readers and users of the [[wiki]] can profit from them.


Also, they are supposed to be nice and cool looking :)
== Current major creations and overhauls ==


Please take a look at the [[OBX proposals|proposed / possible boxes]] being thought so that the initial set of ''useful boxes'' can be built and used. --[[User:Xavi|Xavi]] 21:00, 6 July 2007 (EDT)
* Suggested CSS/skin mods - transclude to your user /shikiwiki.css [[User:Katie/shikiwiki.css]] 11:52, 29 January 2008 (EST)
* [[Site map]] - [[User:ixo|ixo]]
* [[Home]] - [[User:Nlee|Nlee]],
**ndraft at [[Home draft]], goals at [[Home draft/Goals]]. Alternative draft at [[User:Jordan_Craw/Main_Page]]
* [[OLPC:Welcome]] - [[User:Mchua|Mchua]], goals at [[Talk:OLPC:Welcome]]
* [[Participate]] - [[User:Mchua|Mchua]], draft at [[Participate draft]]


=== Health ===
===FAQ subpage structure===
I'm trying to beat the FAQ back into some usable shape. Some short instructions are at [[Answering questions]] - the associated talk page is the place to talk about how this is working. [[User:Homunq|Homunq]] 14:10, 30 January 2008 (EST)
Open tasks for the [[:Category:Health | Health Category]]


==See also==
* Create a health [[OBX]] for interested participants to mark themselves with (should add people to a "Health People" category, or similar
*[[Wiki]]
* Clean up the [[Health Database]] page.
*[[OLPC:Article review]]


=== [[Weekly zine]] ===


[[Category:Common Room]]
* document discoveries, or pages of note
[[Category:Wiki gang]]

Latest revision as of 09:01, 31 January 2009

   This page is part of the Wiki Cleanup Project.   [[ Wiki SEO | Cleanup | Wiki tasks ]]


As information sprawls across the wiki, we're in constant need of help and efforts to keep it tame, trimmed, and usable - purging old/broken information and links, creating and updating portal pages for various user groups and topics... I'm sure you can think of more.

If you'd like to help organize knowledge here, please jump in and edit.

Basic cleanup

Getting started

The first, easiest, and largest tasks on the wiki are ones that anyone can do. Some suggestions:

Mark pages that need work

There are several thousand pages on this wiki. Many of them were created in a hurry and need to be cleaned up. There is a page here on the wiki that contains a large list of pages that have been marked {{cleanup}}: Category:Cleanup. There are two tasks that can be done with this:

  • Go to the Special:Allpages page, and look for pages that need {{cleanup}} added to them.
  • When you find a wiki page that needs cleanup, click the 'Edit' tab and add the {{cleanup}} in the top of the edit box.

Mark obsolete pages

The wiki has thousands of older pages; you can tell them by dates from before 2007; if you see something that looks like a duplicate or older discussion of a highly-linked page, it may be one of them.

There are special templates that flag such pages more specifically than just "cleanup". If two pages seem to cover the same ground, figure out the worse page — the one that's less useful, has less 'What links here', hasn't been significantly updated recently according to its [History] tab, and has the less obvious title. Mark it either

{{merge|Better page}}

or

{{obsolete|link=[[Better page]]}}

Fix pages that need work

It's useful to readers to indicate pages that need work or aren't relevant, but it's far far better to improve or eliminate them.

When you're done and the less good page has nothing relevant and nothing besides old talk pages link to it, remove categories from it and change it to a redirect to the merged page:

#redirect [[New Page Title]]


Major areas needing attention

  • Sign-up lists need to go away. People don't actually reply to them when they set up the lists for people to sign up. People who sign up expect to be contacted and they aren't usually.
  • Glossary could use some thoughtful expansion. Jargon serves a useful purpose as shorthand for technical discussions, but it also poses a substantial barrier-to-entry for new contributors. A more extensive Glossary would be very helpful in allowing outsiders to become insiders.
  • Category:Linux software
    • create standardized format for these pages for consistency, and remove duplication
    • find all standard linux software, tag w/template
    • search wiki for 'yum' and 'wget', likely they need this tag.
  • Examine core wiki pages, (i.e. top pages, or ones in Site map ??)
    • Check for current/correct information
    • move any 'beta' or 'prelease' information else where.
    • Consistency: headers, format, structure, etc
  • review all templates
    • check for duplication, merge if needed
  • review User boxes
    • create consistency,
    • establish best order, if lots on same page
  • review Headers (i.e. page headers)
    • create consistency,
    • establish best order, if lots on same page
  • review Software, and sub-categories
    • Some pages cross over, separate into categories
  • retire Common Rooms in favor of the Talk: pages of actual pages
  • merge all the guides and intros to grassroots and community building pages

Specific projects

supporting 8.2.0 and earlier releases

OLPC wants to support earlier releases for a year (citation needed). And earlier G1G1 2008 recipients got 703 (8.1.0), not spiffy 8.2.0.

  • Suggest a section "In/for earlier releases"
  • use {{consider upgrading}} on pages that describe either 8.2.0 or earlier.
  • Come up with consistent language. Suggest
In [[Release notes/8.2.0|Release 8.2.0]] you ''blah blah
blah''

=== In earlier releases ===
In releases prior to [[Release notes/8.2.0|Release 8.2.0]]
(see [[What release am I running?]]) the commands/instructions/ are different
''blah blah
blah''
{{consider upgrading}}

Green/red country & language lists

The queries for numbers and status in Deployments are the final word on what countries are doing what.

The 2007-era complicated framework of colored countries is dated... kill or replace it (see e-mail to wiki-gang mailing list).

Activity replication and data

Activity versions appear in three or more places

Ideally the last can generate all the others.

Put semantics on all activities

See Semantic MediaWiki#For features for ways to clean up the above.

Some supporting tasks:

Activity Template, Comic Maker, Firefox, Games/Productive, HablarConSara, HelloMesh, Image Viewer, Lambda, OBX proposals, Pacman, Physics, PlayGo, Rollcats, Turtle Art/lang-es, XO-GCC, Xo-get/Xo-get-gtk, XoIRC
  • Test whether a semantic form's template can be at the top of a page, so that {{Activity page}} can generate badges.
  • Activity queries shows there are many activities without semantic info, so if you query for activities, they are not displayed.

A subset of this is activities that have ...? (unfinished sentence by a semantics lover :)

Fix broken external links

from pywikipediabot's weblinkchecker.py

Tasks requiring an admin


Mission Accomplished

Celebrate what we've done.

  • "XO Giving" and "OLPC groups" merged into Regional groups (November 2007)
  • the weird OlpcProject: "fake namespace" mostly retired" (November 2007)
  • Python game stuff cleaned a bit, moved into Category:Developing games
  • the activity pages that claim to be in the G1G1 activity group in Form:Activity and [[Template:Activity page] exactly match the activities listed in Activities/G1G1/8.2. (Some day one might be generated from the other.)


Advanced wiki organization (merged page)

Open tasks

Add a lot of this directly to the opentasks template:

+/-


Pages desperately needing help


February 2008 barnraising

1) Sitemap[s] (good consistent/maintained/watched pages for the public),

- update Table of Contents and other metapages
- organize a "wiki getting started" section similar to that for the XO; at least in outline
-- longer-term : provide a community site map of contributors and projects

2) Categorize outdated pages, archive long pages

- "needs update"  "deprecated" and "archive", "to be avoided"

3) Collections of 'User information' boxes and badges for self-identification of interests and areas where they want to help.

- OBX proposals  (last updated by Xavi and MitchellNCharity)

4) Cleanup of orphans, stubs, and more

- OLPC:Cleanup
- OLPC:Pages for review for pages that get {{delete}} and other tags
- OLPC:Reviews (content review and project review)
- OLPC:Features (featured collections, activities, projects, and media) 
- a stub-sorting/merging/removal campaign

5) Project organization and sorting

- Category:Projects, Category:Software ideas, Category:Content ideas, Category:Hardware ideas
---- add a Category:Ideas to contain the above?
- make navigation-templates, categorize the above into "ideas" "active projects" "inactive projects" and "in use"
- make page-templates to help people generate new pages more easily (See the top of the activities page for an example)

6) Category and template organization

- review/prune the category hierarchy
- review Special:Allpages

7) Newbie-welcoming pages

- OLPC:welcoming committee  
- OLPC:About, OLPC:Welcome, a "why make an account" page
- Help:Contents and links to tutorials
- connection with meta-wiki, wikieducator, wikiversity, wikipedia, wikibooks, curriki, and connexions (a bus stop tour?)

Wiki on-going restructure

You can help with cleanup activities by tagging pages for:

  • Deletion as a consequence of a {{delete}} tag. Caveats apply meaning that it could be deleted - not necessarily that it will be deleted. A sub-category for deletion is specific for #REDIRECT pages tagged with {{deletere}}
  • Merging as a consequence of {{merge}} (seeing all those bits-of-pages, siblings could be found to merge with, or other central pages.)
  • Clean-up as their current state is sub-standard in some way and needs work.

If you can't find a page, check the:

  • Move log - many pages have been moved leaving redirects (that could've been deleted later)
  • Delete log - many things have been deleted...

NOTE: Given the amount of editions (flooding the Special:Recentchanges) you can parameterize the URL in the navigation bar http://wiki.laptop.org/index.php?title=Special:Recentchanges&limit=250 changing the limit as stated below.

Restructuring resources

The wiki provides the Special Pages of which the following is an extract that could prove useful.

NOTE: the built-in search is a bit spotty in actually finding things. The obvious alternative would be Google using a site search limited to wiki.laptop.org or just laptop.org.

Long pages Long means usually means too much to read - note: it doesn't compute embeded pages
Short pages Empty or stub pages should be reconsidered
Orphaned pages Unlinked page should fit within the corpus - note: it could be categorized
Dead-end pages Although valid are also pages that don't invite further exploration of the wiki]]

Maintenance resources

Broken redirects When deleting pages, redirects may have slipped
Double redirects When moving pages, previous redirects don't change
Uncategorized categories Categories should form some kind of hierarchical tree of specialization
Uncategorized pages Pages should fit into at least one branch or area discussed in the wiki
Unused categories Categories should have articles to hold on to
Unused files Files (images and others) should be linked / used somewhere
Wanted pages Is a mixed bag, as it includes mispelled links (ie: upper/lower case) together with close-but-not-quite pre-existing pages, and truly wanted pages. Noise here is rather high due to users never having edited their page and many non-existant Talk pages referenced via templates.
soon I'll add a bit about the special categories, but in the meantime refer to the ones mentioned above in the ongoing process.


Ongoing projects, things to note

Categorization & OLPC boxes

For examples of OLPC box templates in use, see e.g. User:Xavi/Test The liberty the wiki provides in creating pages is wonderful, albeit a bit anarchist; particularly if pages are orphaned or if they are simple dead-ends. Even if they are isolated, categories can help. Finally, templates are a way to systematically format data, and possibly categorize pages in some structured way.

Useful templates should be simple to build and to use. As {{Status box}} and {{Educator}} have somewhat proven, their evolution and ability to incorporte both broad and specific details that are relevant and meaningful hasn't been that easy. My conclusion is that they will systematically fail until we have a comprehensive and structured understanding of too many things that are currently highly volatile.

The solution proposed is a set of atomic templates and a way to group them in a visual way. Needless to say that this is not intended to be just a 'visual effect'; the real purpose is to categorize pages so that they can be retrieved. Although the practice is not much different than normal categorization (ie: making sure the appropriate [[Category:whatever]] appears in the pages) it does provide a more consistent (and easier) way to:

  • Provide not only a category, but also some contextual information about it's belonging there
    For example, a user using the {{user teacher}} box, will end up in the Category:Educators, the same as another user using the {{user teacher primary}} or {{user teacher university}}, but visually you can tell the difference.
    If in the future we want to 'split' the categorizations, modifying the appropriate OBX templates will result in them being sub-classified based on just the template itself, or maybe some parameter required by it.

Not everything will be nice and comfy with them olpc boxes but hopefully they will provide the incentive to create simple templates that address a specific need, for example providing links and categorizations in a visually consistent manner so that the readers and users of the wiki can profit from them.

Also, they are supposed to be nice and cool looking :)

Please take a look at the proposed / possible boxes being thought so that the initial set of useful boxes can be built and used. --Xavi 21:00, 6 July 2007 (EDT)

FAQ subpage structure

I'm trying to beat the FAQ back into some usable shape. Some short instructions are at Answering questions - the associated talk page is the place to talk about how this is working. Homunq 14:10, 30 January 2008 (EST)

See also