Contributor Roles

There are multiple ways community members can contribute to the OpenIndiana Documentation revitalization effort. These contributions fall into several different roles. Each role requires a different skill level.

Prerequisite skills

Basic familiarity with:

Pages are written in Markdown text markup. The skill level required to work with these pages is minimal. If you can use a text editor, you can write docs with Markdown.

Content Author

The easiest way to help the docs revitalization effort is by authoring content. The content author would (as the title suggests) write content to be hosted on the OpenIndiana Docs website. Content can include just about anything, news posts, tutorials, Howto's, or larger efforts such as the handbook or updating the OSOL books.


The nice thing about helping the project as a content author is the level of commitment is entirely up to you the individual. In other words, there is no requirement to get involved in anything major. In fact, it would be better to start small and only later consider taking on something larger.

Helpful skills include a willingness to write and work as a team with content reviewers.

Content Reviewer

The content reviewer wears multiple hats and effectively performs the roles of:

This person (or persons) would review pull request and provide editorial feedback to the content authors. Helpful skills include diplomacy, good organizational abilities, as well as a knack for performing editorial reviews.

The Content Review Process

Upon receipt of a pull request, the content reviewer performs the following steps: