{Desktop 12.10 Topic] Holistic approach to Ubuntu documentation

David david at kvr.com.au
Fri May 25 05:50:18 UTC 2012


Maybe an every increasingly obvious banner at the top of every wiki 
page.

"This wiki was last edited 12/12/2012" - Green
"This wiki was last edited 12/12/2011" - Yellow
"This wiki was last edited 12/12/2010" - Red
"This wiki was last edited in 2009/8/7/6 and may not be accurate" - 
Dark gray

- David

On 2012-04-24 22:17, Chris Wilson wrote:
> Perhaps some mechanism to archive obsolete yet relevant wiki pages
> would be useful here. I'm not sure if the current wiki engine has 
> such
> a feature, or what sort of effort would be required to hack one in if
> it doesn't, but being able to classify wiki pages into
> separate tiers of importance could be helpful.
>
> I also think that keeping the docs for average users, power users,
> contributors and developers (there seems to me to be four sets of
> users, not three as has been mentioned earlier) makes sense since all
> of those groups have different needs. I as a developer would like to
> know how to navigate the Unity source code, or how to quickly learn
> the process for submitting a patch (from start to finish), without
> having to wade through pages of configuration file tweaks aimed at
> power users. A single landing page for everyone starting out may be
> appropriate, but after that I think they should diverge.
>
> Chris
>
> On 19 April 2012 08:30, Matthew East <mdke at ubuntu.com> wrote:
>
>> In my previous email on this thread, I
>> dug out a specification created in 2005, for example. It was
>> implemented over 5 years ago, and hasn't been touched since then, 
>> but
>> keeping it around reminds us why we did something and can be used as 
>> a
>> reference if a similar discussion crops up in the future




More information about the ubuntu-desktop mailing list