CC meeting preliminary notes

[sparkes]

John Hornbeck wrote:
> 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.

agreed, The dev's have a lot of work on their hands and although they 
can answer the odd question it's better to have a single point of entry 
for the days when the dev's really don't have the time to talk over 
every point.
> 
> 
>>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.

I keep saying it but the information architecture is a really important 
thing on a wiki.

We really need to discuss how this will work.  Perhaps an irc session 
with a shared whiteboard (anyone know of one in universe/debian?  I 
still have debian on this laptop due to work commitments and the fact it 
doesn't have a cdrom and I don't have time to write the net install 
how-to ;-) )  could it be meetings 3 days in a row for some?
> 
> 
>>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.

that's the wiki name, the actual english version of the name would be 
Spanish Beadle Install How-to which makes perfect sence as it tells you 
exactly what you are getting with no extra bloat.  If anyone can suggest 
a title that says everything that one does and it shorter I would love 
to hear it ;-)

We need the names to be meaningful and that name is perfect ;-) alright 
it's a little long but it has no wasted words so should be considered a 
good name.
> 
> 
>>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.

The new wiki is also a blank canvas.  We should aim to get it right. 
ATM we have a working wiki with poor architecture.  If we get the 
architecture right on the new wiki existing documents will have a far 
better value to the user.

> 
> 
>>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.
> 
Simon Micheal.

> 
>>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.
> 

I think it was Ben who made all the noise and attempted to get Matt and 
jdub to do it at every opportunity ;-)  Thanks to whoever set it up and 
thanks to Ben for making the right noise until people found the time to 
make it happen.


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

-- 
<davee> "Sparkes, the Pete Best of LugRadio"