httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Daniel Gruno <>
Subject Re: Proposal to move docs to Apache CMS
Date Wed, 02 May 2012 22:28:47 GMT
On 03-05-2012 00:13, Nóirín Plunkett wrote:
> Damn. Because this one looks at the bold "Documentation" link that's
> above the fold, clicks there, keeps navigating on for a bit and can't
> find what she wants. I'm glad that you're able to find them, but
> Subprojects isn't a heading that makes me think "oh, yeah, that's how
> I contribute" or even "oh, yeah, documentation", and when clicking on
> "Documentation" has failed, the plain, below-the-fold "Docs" link is
> not where I go.
> ......
I think a more direct link to how to get involved as a documentation
contributor might be in order, if that's what we wanna aim at.
"Developer info" doesn't strike me as being related to documentation,
but maybe that's just how my mind associates things.

> "transformation" is not a word I would ever think to include in my
> search. Maybe I'm just not who you want contributing to the docs?
> Noirin

I had to be nannied and poked and prodded by Rich myself in order to
figure out how the system worked, and the notion alone of having to work
with SVN, committing changes, updating repos whenever someone farted and
so forth made me a bit scared of the whole system at first, so I fully
understand and share your frustration in how the process is set up. From
what I can gather, with a CMS approach, we could basically tell people
"Hey, go to this address and edit the friggin page like a Wiki", which
in my opinion would encourage far better than "hey, install svn, check
out three or four repos on each of your computers, commit the changes,
rebuild the entire docs site, remember to rebuild the rebuild in case
the revision changed etc etc"

With regards,

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message