How to Participate in OpenSolaris DocumentationThe OpenSolaris documentation community is a group of Sun writers and editors and community volunteers collaborating together to provide up-to-date technical information about using, managing, and developing on OpenSolaris. Have an interest in writing, or do you have experience using OpenSolaris you could share with the rest of the community? Join the docs community. Here's how. Ramp UpThere are several things you can do to get involved in the documentation community:
Provide InputsOpen-source communities thrive based on the open exchange of information and ideas. This is critical to a vibrant docs community, so jump in and help improve the docs by commenting, helping clarify technical accuracy and readability, and filing bugs. Here's how you can help:
Ready to Write?When you're ready to write, there are a few things you need to do. First, all contributors to OpenSolaris need to sign a Sun Contributor Agreement (SCA). After you've done that, you'll need to determine what you want to work on and what format you want to work in. We have open-sourced docs in both wiki format (probably the easiest way to get started) and XML. (We provide Solbook 3.5 XML.) Use these resources to get going:
Work With a SponsorDocumentation sponsors work with the community to support the documentation that is needed for features, projects, bug fixes, and enhancements that integrate into OpenSolaris. We have identified experienced writers from the Solaris writer community who have backgrounds in man pages, system administration documentation, and developer documentation. They will monitor the docs-discuss mail list for questions and requests for assistance. To request a sponsor, send a request through the mail list. The documentation sponsors provide the following assistance:
Feature DocumentationFeature documentation for OpenSolaris includes the following:
The Information Products department within Sun encourages the community to contribute to the feature documentation. The long term goal is to open source all of the Solaris feature documentation. Documentation ProjectsExisting OpenSolaris documentation projects include the following: |