Opensuse-style

From Developer Community

opensuse-style is a style guide project for openSUSE. A style guide is very useful for writers, editors, and developers. These guides are intended for use for all SUSE and openSUSE projects, including SUSE's professional products. The project is licensed under the GFDL so these guides may also be used by other projects or as a base for style guides for other projects.

The main purpose of the guides is consistency. In many situations, there are multiple accepted variants, such as comma rules or spelling of terms. The guides standardize on one of these variants so our manuals and programs can be consistent. Additionally they provide some English guidelines to help nonnative speakers write better.

All discussion of these guides should take place on opensuse-doc@opensuse.org. Please start the subject of style-related mails with "Style:" for clarity. They are maintained by rjwalter. Because of the consequences of changes, no changes should be made without her approval at this time.

This project relies heavily on our sister project, LfL, for technical support. Like with LfL, DocBook is used to format the guides to make it easy to produce documents in multiple formats. Some users prefer a printed version for reference while others may prefer a PDF or HTML document. The opensuse-style SVN links directly to the LfL SVN for the build-related sources. If you want to be able to build these sources, refer to Lfl/Lessons for Lizards Quick Start. Replace the LfL SVN address with the opensuse-style one. Find SVN details in our SVN instructions.

[edit]

Browse the Subversion Tree

Browsing the Subversion tree gives you access to this project's shared source code and files. You may also view the complete histories of any file in the repository.