- title Applications Documentation Cleanup Tasklist
- None yet - tell us what you think and join in.
Tasks for discussion
Please add your ideas for what to do here as a new numbered point and sign with -- duncan-lithgow <<DateTime(2008-07-24T14:12:42+0200)>>
Define our vocabulary
-- duncan-lithgow <<DateTime(2008-07-24T14:12:42+0200)>> At the moment the wiki is full of words which mean the same thing and confuse (especially newer) users. There are probably others so just add them to the list.
- 'Application', 'Software' and 'Package' are used loosely to mean the same thing. The official docs use software I think we should just copy that.
- 'Repositories', 'Software Sources' and 'Channels' are all used interchanged - also in the Gnome Desktop. We should be able to find some bugs reports about that...
Define approval process
2008-07-23 DuncanLithgow said: Because at the moment I'm very active in this little project I think it would be unconstructive for me to propose a process. It needs to be given validity by a wider group of people. So I will just keep working on creating the surrounding tools and infrastructure for this project for now. So please add ideas for a decision process...
2008-07-23 DuncanLithgow added: Discuss and confirm a set of headers. We need to make sure that adding the header adds that page to a category or something similar.
- A header for pages proposed for this project, based on Applications/PageProposed
- A header for pages confirmed as part of this project, based on Applications/PageConfirmed
- A header for pages needing love, based on Applications/PagesNeedingLove. I suppose that AbandonedPages and OrphanedPages would be a goods place to start adding them once it's confirmed.
2008-07-23 DuncanLithgow added: Discuss and confirm a set of templates for the different types of application documentation pages. These should be as close as possible to the Ubuntu System Documentation in structure to minimize work when sections become part of the official docs. I can't any real pattern to the Ubuntu Documentation, they all have 'About this Manual' and 'Introduction' but everything else depends on the topic. They must of course fit in with the WikiGuide. Some possible templates:
- A section template based on MenuDescriptionTemplate - hmm, maybe not. Shouldn't we try to look like https://help.ubuntu.com/ but with a different color or something? That MenuDescriptionTemplate includes the clumsy Gnome Menu thingy which the Ubuntu Docs do not.
- A template for a single application, know any good pages to use as guides?
- A template page as front page for each of ApplicationsDefault SupportedApplications (rename to ApplicationsMain) ApplicationsUniverse. See any good examples?
It looks as though with the help of the NewPage macro we can have editors automatically use the correct template.
well that's a start I guess.