[opensuse-doc] "Lessons for Lizards" Start Today
Hi,
"Lessons for Lizards" is a new way to learn about openSUSE. It is
a documentation project for and by the community (licensed under GFDL)
that will be released on an equal footing with the internally
produced documentation. Lessons are written in a cook book style and
cover more specific or exotic topics than the traditional
manuals. For example:
* Experimental or nonstandard software
* Third party software
* Third party drivers
* Unusual hardware
* Complex setups (such as configuration of a home network server)
The Project So Far
-------------------------------
We've set up a project on Novell Forge
(http://developer.novell.com/wiki/index.php/Lessons_for_Lizards) with
lots of information and a basic functional document. Our software
package installs the necessary build environment (including scripts
and style sheets).
The basic SVN structure is set up and we've gotten started with
some documents. If you want to learn to use it all, take a look
at
http://developer.novell.com/wiki/index.php/Lfl/Lessons_for_Lizards_Quickstar...
The Future
-------------------------------
Our guide has barely cracked out of its egg. We know it needs:
* Content--it's very hungry
* Testing and more documentation for the LfL quick start guide
(we're already working on this)
* Better support for FOP configuration (the program that turns
DocBook into PDFs); our gurus are hard at work here
* You
Yes, the documentation team needs YOU! (No, we don't mean the online
update tool)
If you have a special topic to document, want to work on the guts of
the DocBook stylesheets or FOP build environment, have dreams of
becoming an editor, or just want to help out by testing what's been
written, this project is for you.
We have XML gurus and experienced writers and editors at the ready to
help you make this the manual of your dreams. What do you want in an
openSUSE manual? Join
participants (1)
-
Thomas Schraitle