DocTeam write-up

[Alexander Poslavsky]

Hi guys(mv)!

After our discussion on irc about not discussing on irc i decided to
do a write-up on my thoughts on how things are going on the
ubuntuwiki. The first thing to say is that it is going really well. We
have lots of really nice pages and quite a number of different
contributors. In short, for such a new distro, not bad at all.
What is not so good? I wrote some thoughts. What do you guys think?

greets, AP



If you look at the SiteMap you can see there is structure is lacking
in the wiki as it is today. Many parts of the wiki can not easily be
reached nor found. We need a clearer structure and from that structure
branch out. An example:

To get from FrontPage to BeagleHowto I would need to:

1. Ah, a link called HowTo Guides, unfortunetely this page brings me to:
	http://ubuntuforums.org/forumdisplay.php?f=15
	http://www.ubuntulinux.org/support/documentation/howto
that is not what i was looking for, back to FrontPage
2. Second attempt ... again a link to the ubuntuforums... Further down
... Finally burried between a bunch of other links the
DocumentationArea, from there I can find the howto's. That was too
dificult.

I have nothing against the forums, but the wiki is supposed to be a
source of information not just a short link *out* of the wiki.

What do we need to do (on the new wiki) ?
 1. we need priorities, what do we want to use the wiki for? in
support you will see howto's and tutorials as well, why? what do the
people who visit the wiki look at? can we somehow see that?
 2. Bring structure in the wiki (see further down)
 3. Make good templates for the creating of new Howto's so they look
more or less the same. (Does plone support that???)


Some ideas on structure in the wiki:

http://www.ubuntulinux.org/support/documentation/helpcenter_view has a
nice structure. We could use something like that. We would get a page
looking like:

----beginning-of-page-----
Ubuntu wiki

1st paragraph. Introduction, what is wiki, what is ubuntu etc , etc,
text text text etc

2nd paragraph of intro, more text. and even more.

SiteMap:

Documents ->
     Development (this would be links, with an explanation)
     Errata      (idem dito)
     FAQs        (also here)
     Glossary    (well, you get the idea)
     How-Tos     (...)
     Places to find technical support 
     Security Notices
     Tutorials
     Ubuntu Document Writing Guidelines
     Ubuntu Teams 

End-notes, some more text. And more text. And a picture :)
------end-of-page-------

>From here it would be easy to make sub-pages eg the Howto page:

----beginning-of-page-----
Ubuntu Howto's

Applications Howto's       (a link)
Installation Howto's       (one more link)
Kernel Howto's             (...)
Even more specific Howto's (...)

Search Howto's: [          ]

List of ALL Howto's (a link)
->How to add you own Howto (a link)
------end-of-page-------

All main groups could have a frontpage like the one above, from there
it would be easy to find what you need.