From docs-return-10531-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org Fri Apr 13 18:40:26 2012 Return-Path: X-Original-To: apmail-httpd-docs-archive@www.apache.org Delivered-To: apmail-httpd-docs-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id B1A3E9963 for ; Fri, 13 Apr 2012 18:40:26 +0000 (UTC) Received: (qmail 94631 invoked by uid 500); 13 Apr 2012 18:40:26 -0000 Delivered-To: apmail-httpd-docs-archive@httpd.apache.org Received: (qmail 94591 invoked by uid 500); 13 Apr 2012 18:40:26 -0000 Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: docs@httpd.apache.org List-Id: Delivered-To: mailing list docs@httpd.apache.org Received: (qmail 94580 invoked by uid 99); 13 Apr 2012 18:40:26 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 13 Apr 2012 18:40:26 +0000 X-ASF-Spam-Status: No, hits=2.9 required=5.0 tests=HTML_MESSAGE,SPF_NEUTRAL X-Spam-Check-By: apache.org Received-SPF: neutral (nike.apache.org: local policy) Received: from [217.160.171.50] (HELO jupiter.hal-nine-zero-zero-zero.net) (217.160.171.50) by apache.org (qpsmtpd/0.29) with SMTP; Fri, 13 Apr 2012 18:40:18 +0000 Received: (qmail 31255 invoked from network); 13 Apr 2012 18:39:57 -0000 Received: from unknown (HELO evanda.localnet) (217.160.171.50) by jupiter.hal-nine-zero-zero-zero.net with SMTP; 13 Apr 2012 18:39:57 -0000 From: "Astrid 'Kess' Malo" Reply-To: kess@apache.org To: docs@httpd.apache.org Subject: Re: Docs Frontpage Date: Fri, 13 Apr 2012 20:35:46 +0200 User-Agent: KMail/1.13.7 (Linux/3.0.6-gentoo; KDE/4.7.4; x86_64; ; ) References: <4F8849A2.5020904@cord.dk> In-Reply-To: <4F8849A2.5020904@cord.dk> Organization: Apache Software Foundation X-KMail-Markup: true MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="Boundary-01=_CIHiPyy/kF4qlLp" Content-Transfer-Encoding: 7bit Message-Id: <201204132035.46797.kess@apache.org> --Boundary-01=_CIHiPyy/kF4qlLp Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit 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. 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. Regards, Kess --Boundary-01=_CIHiPyy/kF4qlLp Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: 7bit

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.

 

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.

 

Regards,

Kess

--Boundary-01=_CIHiPyy/kF4qlLp--