The MOTU wiki has grown a lot over time. It has pages that are out of date, inaccurate, duplicate information. This confuses new contributors. We are going to fix this by dealing very strictly with it. We'll have definite documentation and will fix namespace issues.
Documentation is our biggest help in getting new contributors started. Having documentation easily available is the most efficient way in sharing our knowledge and learning ourselves.
Daniel forgot how to use the quilt patch system, he searches for "patching sources" and finds the wiki page.
Sébastien finds himself explaining how to do a merge for the third time this month. He simply points the new contributor to the definite guide.
Matt wonders how development processes differ between main and universe. UbuntuDevelopment answers his questions.
Michael wonders, what the MOTU team is about, he checks out the wiki page and finds that it's the team, where Universe development is happening, that it adheres to UbuntuDevelopment and its wiki pages are tidy and easy to read.
It's easier to learn about UbuntuDevelopment in general. Having two namespaces with different explanations of the same thing make it harder to understand.
- We will cut down duplication of wiki pages and have definite guides.
We will work down the list and clean up page by page.
We will tag pages that can be removed as CategoryMOTURemove and add [[Include(MOTU/Headers/WikiRemove)]].
We will add [[Include(MOTU/Headers/WikiMergeUbuntuDev)]] to pages that need to be moved to UbuntuDevelopment and subsections of it. Maybe we can use CategoryProcess to better find pages including information that is general and process-related.
We'll add [[Include(MOTU/Headers/Menu)]] to MOTU wiki pages to give them an official blessing.
Pages we intend to get merged with the Ubuntu Packaging Guide,
get tagged as CategoryMOTUUbuntuPackagingMerge.
To sum up the idea in a 'rule of thumb':
- Process and documentation information should be easily findable and avoid the risk of duplication.
The bits that in their core are really MOTU-centric are very few.
We will have redirects from old URLs to new ones.