Ah, interesting. When you showed me your architecture, I mistakenly
assumed the documentation link would go to the doc community site, not a
doc aggregation page. Honestly, not sure what to think about that.
Certainly, access to info at a more immediate level is a good thing. I
do think keeping this list fresh and up to date is going to be a challenge.
Couple of things about your beginning/ending bookend paragraphs
referencing the doc community. Given my attempt to focus on discrete
audiences (contributor, translator, downloader, developer, admin) on the
doc community page, maybe say something more along lines of....
The _Docs Community_ provides detailed information on how to
participate in OpenSolaris documentation, access to open sourced
documents, and pointers to detailed information about setting up
and developing OpenSolaris.
My personal preference is to use fewer inline links, so maybe just the
one to the Docs Community page and let that be the portal for user
access of the info rather fork folks off to multiple links within the
paragraph. Am sure there are usability arguments that cut both ways on
use of inline links. My $0.02.
-alan
michelle olson wrote:
> Hi all,
>
> I've drafted a Documentation landing page for the site this week, with a
> link in the main left-navigation. It is just a first draft, so any and
> all comments are welcome. (Note: I replaced the Get Help link with this
> one, since Bill implemented the Get Help icon in the upper-right last week.)
>
> http://opensolaris.org/os/documentation/
>
> Let me know what you think about the sections, order, accuracy, and if
> anything is missing and general sanity checking. Where I'll need your
> help most is keeping this fresh, so as you find and read or post new
> documents, send the links to this list and we'll add them.
>
> Thanks!
> Michelle
>
>
> _______________________________________________
> website-discuss mailing list
> [email protected]
>
--
Alan McClellan
OpenSolaris Documentation Community Manager
#32171
+1 719-352-0993
http://blogs.sun.com/docexchange/
_______________________________________________
website-discuss mailing list
[email protected]
