httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Re: Auto-docs rewrite
Date Fri, 22 Jul 2005 07:50:28 GMT
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

>> So httpd.apache.org/SomeDirective?
>>
>> Where would it go? 1.3? 2.0? 2.1? 2.2? Just the latest stable?
>> If we get a consensus on this I have no problem with that stuff in
>> general.
> 
> I'd say 'latest stable' (2.0 at the moment).

Yes. Latest stable.

> How do we expect people to find out about the existence of this feature?
>  We could really use an improved /docs-project/ page to give better info
> about the docs.

I'm not sure how I found out about the php.net autodoc function. It's
just something that "everybody knows". So, yes, we should advertise it,
and I think knowledge of it will gradually spread.

> I'd also probably recommend using httpd.apache.org/goto/SomeDirective or
> even httpd.apache.org/docs/SomeDirective  to avoid namespace conflicts
> and extra filesystem checks that are needed if we overlap with the main
> website.

Well ... I'm really not terribly thrilled about that. The goal is to
make the URLs as simple as possible. I know this is repetitive, but what
I'm trying to emulate is the fact that I can just type "php.net/getdate"
in my browser and get the docs for that function. It makes it amazingly
fast and easy to get documentation when I'm working. I want Apache to be
that easy. I'm much more interested in the user's ease of use than
having the "right" url structure.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (Darwin)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFC4KVEXP03+sx4yJMRAiUHAJ4/w3djSToTCLzKIbhhPToGnL47GACgsZUa
59Ng4jhJba/MQpLq5A3KblI=
=VEgx
-----END PGP SIGNATURE-----

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


Mime
View raw message