Hi Peter,
Thanks for the review comments, my replies inline.
Peter Tribble wrote:
On Fri, Nov 7, 2008 at 11:55 PM, michelle olson <[EMAIL PROTECTED]> 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.
First, a general comment. How does this relate to the docs community
home page? I think we need to be clear how the two relate - I remember
querying whether the docs community page ought to be a docs landing
page. I'm not so much bothered what the answer is as whether we clearly
understand (and, more importantly, that visitors can clearly see) what;s
supposed to go where.
This page is a collection of links to documents located in all the
Communities and Projects across the entire site. So, it has a broader
focus than the Docs Community landing page.
Anyway, on to the page itself:
It's almost 5 pages long; I'm worried whether people will scroll down.
Could the headings be links at the top that jump down to the right place?
Yes, absolutely. I will create a 'jump list' of links at the top.
Some of the categories look, well, odd. The first section mixes packaging,
databases, and education. I wouldn't put DTrace and ZFS together. So I would
change the categories. In no particular order:
ZFS
DTrace
Databases
Distributions
Virtualization
IPS (and making packages)
CIFS and Windows (which is separate from NFS etc)
Crypto
Networking
X11 (including desktops like xfce and JDS)
SMF
Storage (which would include mpxio, hadoop, QFS, FCoE)
Observability (including debugging, performance, benchmarking)
I hope you get the idea.
(I was intrigued to find JKstat alongside printing, games, and mdb. Definitely
an eclectic bunch!)
Understood, I struggled with how to present the topics and attempted to
slice them in a way that was different than the Community organization
we have. I put them in order of most heavily requested (based largely
on several years of watching the help and docs mailing lists) as well as
most heavily downloaded according to the analytics data for our site. I
will take a peek at the analytics for this page in the coming weeks to
see if folks scroll down, etc. and use that data to inform improvements
to this scheme or to change the direction as you've suggested.
Thanks,
Michelle
_______________________________________________
website-discuss mailing list
[email protected]
