So there are at least two of us. :) Yes there are :) Although I still think the "help" is a better term for the start-page then "documentation". The problem is that with the current layout you will get a very long list, which I think is not very helpful. (http://en.opensuse.org/Howtos) so one would have to have at least two columns to have better use of the available space, if one wants to arrange topics with only a sentence as decription. I really like the help-topics on your start page especially things like "interaktive Hilfe" How about making a step in between and putting it on the Dokumentation site. Is better than having nothing at all. I think it would be really nice to have a more separated documentation section in the left navigation bar (maybe something named help as own topic) and
Am Sonntag, 14. Mai 2006 08:21 schrieb Sven Burmeister: Hi! linked to the main headlines inside the wiki but this must be done by someone else.
Just compare http://en.opensuse.org/Hardware and http://en.opensuse.org/Howtos. I think it is clear which one is clearer. Ack. But if you take only the 10 headlines and link on another page for each topic the howto page will be human readable.
Another thing I so not like are the current topics on http://en.opensuse.org/Documentation. Me to. for example i don't like the "start here" section at all. most of the articles in there are also in the "User Documentation". So what is what and where to go first? In the end it's the same.
- Installation - Articles covering all aspects of the installation of SUSE Linux.
Why is the topic "installation" just bound to installing Linux, why not make installing Linux the top item of that category that handles software installation in a more general way. +1
- Configuration - System and application configuration articles.
These articles describe how to configure, e.g. a web-server, so they are mostly howtos, are they not? +1
Hardware - Supported platforms, hardware compatibility lists, tweaking, optimizing, and troubleshooting.
There are hardly any articles in there, so there is not much to say. I think Hardware compatibility list should be in front. Most of the users are searching for that. PPC also in front. Think we are going with more then only one article on this topic. (or is it a howto?) The rest splits in the other categories.
Howtos - Howto Guides on a wide variety of topic
So there is a page with all kinds of howtos, which on the other hand can slo be configuration-articles, or trouble-shooting howtos, or installation-howtos.
What about taking the another approach, i.e. having topic-relevant hardware-comptibility list, config and howtos in the wlan-section, instead of having wlan spread all over config, hardware and howtos? Just another another way round. In think howtos and faq are names users are used to all over the internet. If someone is looking for help, he is looking for this topics. Don't take them away. But.... *grübel..* isn't nearly everyting a howto in the one or the other way? Don't know a solution for that by now. You may be quit right. How about having a howto section and linking from the other categories also to the howtos? May be a mess with a lot of broken links. I don't know.
Didn't want to say we must do every thing like in the en wiki but I think the main pages like Front page, Documentation page ..etc should look something simular. Changing this should be a general discussion. The content may be different.
That discussion was started several times and always ended very quickly without any "approved" changes to the wiki. Hhmmm..... Just wanted to do something, because I see a real lack of German documentation. I know some not English reading users and it is really hard for them to find some help outside the official Novell documentation. So I think doing something that may be changed in the near future and I don't see as the best solution, is better than doing nothing at all.
By the way I fully agree with the words of Peter Flodin answering to your mail:
"I see we really only need three or four of us to agree on a structure and then just do it.
The thing not to forget is that with the wiki you don't need community consensus to do anything and it is self-repairing. The more people you annoy with an edit the more people take an interest and voice their opinion on what they think. It is nearly always a win-win situation"
Regards, Olaf