Re: [RFP] A more maneagable way to include documentation
On Mon, Mar 20, 2000 at 09:37:08PM +0100, Josip Rodin wrote:
>
> I wouldn't force it to be at the very beginning: as long as it is provided
> and it works (i.e. it points to an address behind there is someone that is
> really going to read and answer it), it should be fine.
>
IMO, the contact address should be at the beginning. It should be clearly
visible so there is at least a small chance that people will use that address
instead of webmaster.
> I say this because the FAQ will have a <ref id="authors"> in the <author>
> tag, so this wouldn't be the compliant to what you propose. I imagine some
> other documents could do the same.
>
> BTW what seems confusing to me is that people fill the <author> tags with
> the names and addresses of all contributors to the document. Frankly, I
> don't think the reader needs to know about all of those e-mails (especially
> when there is another unique address to contact the maintainer), and the
> more times you mention an e-mail, the more spammers mail you :(
>
Let's just specify that <author> only contain names. generic contact addresses
should be used. debian-doc may be sufficient.
--
James (Jay) Treacy
treacy@debian.org
Reply to: