httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Igor Galić <i.ga...@brainsware.org>
Subject Re: Docs Frontpage
Date Sat, 14 Apr 2012 00:47:22 GMT


----- Original Message -----
> 
> 
> On Friday 13 April 2012 17:43:30 Daniel Gruno wrote:
> 
> > would like to see it shaped differently.
> 
> > I've quite often found that I simply couldn't find what I was
> > looking
> 
> > for, because my own mental point of entry was more along the lines
> > of
> 
> > "I'm a developer, where do I start?", which is hidden away in the
> 
> > "other" section.
> 
> 
> 
> Years ago I had a friend moaning about the httpd docs. He said, he
> could never find what he was looking for. And if after a lot of
> searching he got it, he could not understand it because of his bad
> english. This has been the impulse for my translation effort.
> 
> 
> 
> Some time later, I realized, translation is not everthing. The
> current documentation is written from a developers view. You have to
> be familiar to the "httpd language". You already have to know the
> concepts, possibilities, and an overview over the existing (or at
> least the most common) modules. This is a hughe burden for really
> new or occasional users.

I think we've toyed with a similar idea sometime back but using
stackoverflow as source.
The data there might be easier accessible/processable

> But I am already to failiar with the Apache to be able to look at the
> docs from a beginners view. So some time ago I thought about
> collecting, sorting and grouping user questions from users@httpd to
> get an idea for their perception. Due to a lack of time I never got
> into it.
> 
> 
> 
> But this approach might help reordering the frontpage.
> 
> Imho mostly unexperienced user start there. Experienced users know
> where to look and go straight to the correspnding page using the
> shortest known way through the navigation.
> 
> 
> 
> So let's look at the user questions and collect the corresponding
> pages which might have helped them. By the time we might see some
> group of topics and corresponding pages. Those should be the base
> for our new frontpage.
> 
> 
> 
> We might - no, I'm sure, we will - also see a lot of questions, which
> are not easily answered with our currend docs. Writing new pages
> and/or improving existing ones will then be the next step towards an
> easier to use documentation.

+1

> Regards,
> 
> Kess

i

-- 
Igor Galić

Tel: +43 (0) 664 886 22 883
Mail: i.galic@brainsware.org
URL: http://brainsware.org/
GPG: 6880 4155 74BD FD7C B515  2EA5 4B1D 9E08 A097 C9AE


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


Mime
View raw message