Explaining the various doc sites
I'm often asked to explain the difference between the documentation page at the top level of the OpenSolaris.org site (www.opensolaris.org/os/documentation ) and the documentation community pages (www.opensolaris.org/os/community/documentation) I maintain.
Awhile ago, I exchanged some email with Michelle Olson, who currently maintains the top-level OpenSolaris.org web site, including that documentation page, and compared notes. Here's what we came up with:
- OpenSolaris.org Documentation Page - The purpose is to aggregate various OpenSolaris content across the .org community and the many projects/communities that support it. The explicit audience is the OpenSolaris community member looking for supporting information on how to learn about and participate in OpenSolaris.
- OpenSolaris Documentation Community - The purpose is 1) to support community members who want to participate in OpenSolaris documentation or re-use OpenSolaris documentation and 2) to provide specific support on setting up and developing on OpenSolaris. The latter includes things such as 'beta' drafts of support information for developing on OpenSolaris, which ultimately find there way into the official product documentation that supports a binary release. The explicit user is the OpenSolaris community member who wants to be involved with documentation. The implicit user is the OpenSolaris user who is looking for support on using, setting up, and developing on OpenSolaris.
So, if you've scratched your head wondering about the purpose of these two sites, hopefully this explanation will help a little
