CC meeting preliminary notes

[John Hornbeck]

On Tue, 2004-10-26 at 08:19 +0300, Alexander Poslavsky wrote:
> Hi DocTeam!
> 
> tonight will be the CC-meeting and it would be nice if we can get some
> decisions on the DocTeam as well. I will not be able to make it
> probably, if it starts earlier i'll be at the beginning if not i might
> be at the end... anyway some thoughts i think that need to be covered:
> 
> It would be good if we have a team-leader, it might bring more
> structure to our team and make us more productive and effective.
> 
I also think a leader is needed.  If nothing else than someone who can
go between the upper devs and the doc-team.  We need one person who can
go to them with questions and to keep up with what is going on.

> What do people think of the wiki so far? I find it hard to find the
> important stuf (=Howto pages etc). How to make the wiki more
> accessible.
> 
I find the old wiki to be nice but not organized.  I think once we
figure out some stuff and get a structure we can really get moving on
organizing it.  Alot of us have put things on hold till we really know
what is going on.

> Other languages. Are the toplinks ok (look at NefFrontPage) for an
> example? Naming for other languages, i like ComoSomething for spanish
> Howto's better then SpanishWikiPage. It will be easier to find stuff
> if pages are name logically/consistantly.
> 
If we start using naming like that we are going to get some really long
names.  SpanishBeagleInstallHowto, that is just to long.

> What to do with the new wiki, does it work, when will we start to use
> it? What will be the preferred markup-language? Kupu is easiest but
> then all pages will look differently, moin is easiest, then we still
> have structured and restructured text. The last two are powerfull but
> need better, easier documentation.
> 
The new wiki is a mystery to all.  I do not think it should be used
until we have bugs worked out. Don't get me wrong, play with it, mess it
up, and break the crap out of it.  You will not find bugs without
attacking full force, but at the same time, we don't want to stop making
docs that are usable so I don't think it should be used exclusive.

> If we are supposed to start using the new wiki then we need help and
> documentation. I have been making pages but it is difficult to make
> normal pages, links to other pages. I do not understand why some pages
> are Singletons and some are not, why do some pages pop up in the
> side-bar and how do i remove them from there? And how do i put a page
> i made in the side-bar? Can we ask wiki-questions on the
> ubuntu-doc-mailinglist, on irc?
> 
We have had the dev's of the new wiki say to ask them anything we want.
Some of them do read this list, so you might ask on here, or read
through the list as the main guy has posted before.

> The ubuntu-doc list seems a really good idea. We should thank whoever
> thought that up. Off course it would be nice if in the future at least
> the documentation-leader would be in the loop of changes that have
> influence on the docteam. He could the keep the rest of the team
> up-to-date.
> 
The list seems to have came from Matt Zimmerman.  It was a great idea
and I am glad to be able to moderate it.



John Hornbeck
http://hornbeck.freeshell.org/blogger