[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Style Guide (was Re: I'm a sucker)
On Mon, Oct 09, 2000 at 10:14:27AM -0700, Gregory Leblanc wrote:
> Right now, the LDP doesn't have all that much respect from much of the Linux
> community. I'm on the mailing lists for quite a few other doc projects, and
> occasionally the LDP will come up, and it's almost never mentioned in a good
> light. I'd love to see this change (which is why I'm on the list), but most
> people can't put a finger on what it is that they don't like.
> A lot of people see the LDP as just a big group of individual, without any
> sense of direction at all. In many respects, this is correct. I think that
> a style guide, helping to give a more consistent "look and feel" to our
> documentation would go a long ways towards giving the LDP a more
> professional image.
When I was at the LDP booth at Montreal, I had some visitors tell me
that many HOWTOs are not up to date. Another problem is that there
are a lot of topics they don't cover, or a certain HOWTO fails to
contain the info they are seeking. This is our main problem: the
technical quality and completeness of our documentation. The look and
feel doesn't make all that much difference.
How do we fix this? We recruit more authors and make it easy for them
to get started by among other things, giving them the clear option of
To UNSUBSCRIBE, email to firstname.lastname@example.org
with a subject of "unsubscribe". Trouble? Contact email@example.com