Re: [HACKERS] Contrib modules documentation online

On 8/29/07, Mario Gonzalez <gonzalemario(at)gmail(dot)com> wrote:
> On 29/08/2007, Neil Conway <neilc(at)samurai(dot)com> wrote:
> >
> > I wonder if it would be possible to keep the master version of the
> > contrib docs as SGML, and generate plaintext READMEs from it during the
> > documentation build.
> >
>
> Hello Neil, I think I'm doing something similar but not with README
> files. Currently I'm writing the FAQ into Docbook XML, that's why we
> can build the HTML and plain text at one.

While I like the idea of the READMEs from contrib being in the docs, I
can't tell you the number of times I've installed a contrib module in
a dark ops center at 2am with no html browser handy (or at best a text
based one) or with no access to external internet etc... and just
needed a line or two from the README file that came with the contrib
module.

Could the contrib README files couldn't be generated from the same
source as the docs (i.e. sgml) and then put into the appropriate
contrib/module/ directory.