httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Docs page rearrangement?
Date Sun, 15 Jun 2014 13:37:58 GMT
I've been reading Anne Gentle's book Conversation and Community -
http://drbacchus.com/books/1937434109 - and I'm thinking about some
things we can do to the httpd docs site to make it less user-hostile.

I've long been frustrated with the docs landing page, regarding the lack
of clear path. Where do I go if I'm getting started? How do I know what
I'm looking for, when docs have names like Handlers and Filters, and I
don't know what those words mean? That kind of thing.

Anne says that it's helpful for docs to be divided into categories:

* Start Here
* Reference Guide
* Tutorials
* Learning/Understanding
* Cookbook/Recipe

We have all that content, but it's arranged somewhat haphazardly, which
hinders both the learner and the potential writer.

I'm thinking of rearranging the docs landing page into these categories,
and in the process trying to make it a little more welcoming. I'm
somewhat hindered by the fact that I'm design-challenged, so if any of
you have input into this process, I'd love to hear from you.

-- 
Rich Bowen - rbowen@rcbowen.com - @rbowen
http://apachecon.com/ - @apachecon

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message