[Design] Finding Documentation

Travis Vachon travis at osafoundation.org
Wed Nov 28 14:13:12 PST 2007


Hi folks

I've been trying for the last 10 minutes to navigate to the Chandler  
Server documentation from http://chandlerproject.org and I've come up  
empty handed. In general, finding "Documentation" via this page is  
rather tricky.

Things I do see:

* Links to download the server or desktop client and sign up for a Hub  
account. One of these links actually takes me to the page I'm looking  
for, but since I'm not trying to download anything I didn't think to  
click it until just now.
* Introductory information (FAQ, "Getting started", etc)
* A link to a wiki that takes me to a high level overview of what the  
project is about, how to contribute, etc

What I want:

* A link to reference documentation on the front page of http://chandlerproject.org 
. In this case, I want something that will take me to a page that has  
a link to "Server Administrator Documentation." In the future,  
however, I'll very likely want a link to a page that has a link to  
"Chandler Desktop Documentation." "Chandler Desktop Documentation"  
would be a table of contents that I can navigate to find out how  
feature X works (from an end-user perspective) without a whole lot of  
handholding.


I think we're doing pretty well as far as introducing people to the  
software goes, but I found the workflow for "experienced" users trying  
to figure something out pretty frustrating.

A couple questions:

* Does the "Project Documentation" page I'm looking for that links to  
ToC pages for the documentation for each project exist?
* Do the ToC pages for the documentation for each project exist?

Also, let me know if I'm being blind...

Thanks!

-Travis


More information about the Design mailing list