Thanks for the comments/questions, Peter! Replies below.
Peter Tribble wrote:
> On Thu, Aug 6, 2009 at 6:46 PM, alan mcclellan<no-reply at opensolaris.org>
> wrote:
>
>> As I've mentioned, I'm in process of reviewing the docs community site and
>> cleaning it up prior to the 9/14 content migration to xwiki. To that end,
>> I've come up with a site architecture document that shows how I would like
>> to re-organize the site. I would greatly appreciate any inputs from folks
>> here who care about such matters. Take a look at the PDF site architecture
>> document here:
>>
>> http://opensolaris.org/os/community/documentation/reviews/docs-community-site-architecture-01.pdf
>>
>> As you'll see in the slides, I'm basing the site layout on the premise that
>> purpose of the site is to support the user community that wants to:
>>
>> ? Contribute to OpenSolaris documentation
>> ? Redistribute OpenSolaris documentation
>> ? Contribute code to the OpenSolaris project
>> ? Set up OpenSolaris and develop applications on OpenSolaris
>>
>
> I guess I'm slightly confused by the latter two bullets here.
>
> If I wanted to contribute code to X, I would expect to go to X to find
> out how to do it. So, why is that covered here as well? Part of that
> question is: are you linking back to X, or does X link back to docs?
> In other words, are you providing links to help people because
> they've come to the wrong place, or is this the right place they should
> have come to first?
Historically, I _think_ the docs community was something of an
information hub for all of the .org community, so this stated goal is a
bit of a holdover. As I read your comment, I believe you're suggesting
that we let the communities/projects be the natural home for how to
contribute code, correct? That seems like reasonable approach to me, and
it does reduce the need to try to duplicate content from the various
development-focused projects and communities.
> (So for another project or community, what can they expect to do in
> terms of interactions with the docs community when they're writing
> docs: do they come to you for tools, standards, a repository for the
> finished documentation, or even authorship resources?)
>
Good questions. I would hope we could support any of those things if
another community/project sought that kind of support. Currently, seems
like communities/projects are self-reliant in developing and publishing
[in their spaces] their content. So, this doesn't seem like a need, but
maybe would be good to better advertise some of these ways we can help.
> There's a lot of stuff you just link to right now (quite a lot on
> wikis.sun.com
> for example) - is the intention to keep it spread out, or to bring more of
> that
> material onto os.org once we've got the new infrastructure?
>
I am really anxious to set up a community contribution / collaboration
space when we've got the new infrastructure. However, I expect things to
be spread out for while.
> I'm also unclear on the Access Info bit of the tree - some more explanation
> of what that is would help me out.
>
Yeah, that's a crummy name. I'm really intending for this to be link to
find docs on setting up and developing on OpenSolaris (bullet 4 in the
goals).
