Andreas Jaeger wrote: > Just a short remark to this thread: > > Novell has a documentation team working on our manuals, nothing has > changed here (see http://en.opensuse.org/Documentation_Team). It's > not developers writing manuals, it's dedicated editors - some of them > coming from development and others from other areas. > > Since we have a holiday on tuesday, most of us take a long weekend > (monday of as well), so don't expect direct feedback on this by the > documentation team. > > Somebody mentioned that software is only finished at the end - this is > not completely true since openSUSE. My goal is to get features in > early so that they can be tested and documented early. It's still > very tight for the documentation team but it was even worse before;-(. > > Cheers, > Andreas
Thanks for the response Andreas. I know that developers don't write documentation, at Novell, but in the most of small projects they do, and that is where serious improvement is needed. Novell/SUSE guys are trying hard to bring people in, but still, one needs too much to learn before can start contributing. One preconfigured package/pattern that contains all available software for documentation writing, for instance SVN with links to Novell repositories, editor with Novell like templates, and probably much more, will make volunteers life easier and move focus from tools to content. I hope that documentation guys will have some answers, instructions, ideas, as we need some in order to get involved. My idea of ideal world of documentation writer is one browser where one can read existing manuals, howto's etc, than when something was found start editor and change document. When done, submit for approval, proofreading and that's it. After some time get feedback, if it is accepted or not, or in need of further changes additions. In this world somebody else will think how to structure whole documentation, where to move balance, how to name articles. -- Regards, Rajko. Visit http://en.opensuse.org --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
