The Documentation Apocalypse

[zenyatta]

Btw I wrote Rich about my interim wiki when asking for a confirmation e-mail. No response so far.

[lardman]

2. sounds fine to me, just as long as we have a thread so that people can suggest things.


Si

[zenyatta]

It has occurred to me that my domain/web space is in fact a separate service from my DSL connection - which means it does not fall under the 1000MB limit. Option 1 is thus perfectly viable although I will consult my ISP before posting any URLs publicly.

I do feel a bit silly for having missed this little detail, sorry for any confusion. Given the circumstances, I would slightly prefer option 1 over option 2 - we need as many contributors as possible.

z.

[ksignorini]

I also prefer zenyatta's original wiki.  We know the format (zenyatta did a great job with the contents page), wiki is easy and collaborative for everyone, and it's already set up--no waiting for passwords, etc.

So if #1 works, it has my vote, too.

Kent!

[zenyatta]

Hear ye, hear ye!

Anyone who wants to contribute to the new OpenZaurus User Manual effort should head over to http://www.journey.sk/zwiki/index.php/HowToContribute where you will find a few guidlines to get you started. The User Manual is an open, unrestricted Wiki with a Table of Contents already in place and some sections already partially written. You are welcome to submit content, fix mistakes and add editorial comments at the bottom of each section. General editorial comments and discussions should be reserved for ZUG forums (either this thread or a new one). The aim is to eventually have a comprehensive manual that can then be ported to openzaurus.org.

z.

[rolf]

This is a good idea in my opinion as well.  I would think that a natural layout (for a contents page, etc.) could be:

[...]

I have also put some thought into how to organize and structure the OZ page.  I posted my ideas to the OZ mailing lists at the end of last month.  I came up with something similar to ksignorini's ideas. You might want to take a look at

http://article.gmane.org/gmane.comp.handhe...aurus.user/9858
http://article.gmane.org/gmane.comp.handhe...aurus.user/9895

I really think the OZ site has to make sure it caters to the different needs of its different visitor groups (I sketched out three groups: people interested in OZ, plain users, developers).

[zenyatta]

Nice thought, although I think splitting "Docs" into "User Manual" and "Developer Manual" would make the visitor groups more distinct and expanding the menu by 1 item would be perfectly justified. "Docs" just feels very general to me. It can mean almost anything.