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, Daniel. --------------------------------------------------------------------- To unsubscribe, e-mail: docs-unsubscr...@httpd.apache.org For additional commands, e-mail: docs-h...@httpd.apache.org
