From: Martin DeMello <martindemello@...>
Date: 2008-08-07T01:04:42+09:00
Subject: Re: perl and the culture of libraries

On Wed, Aug 6, 2008 at 7:43 AM, David A. Black <dblack@rubypal.com> wrote:
>
> It has indeed. I think that at this point, it's unlikely to impossible
> that a system or standard is going to emerge that everyone follows, at
> least at the granularity of what the section headings in documentation
> are called and all that, and probably even at much coarser
> granularity. To some extent, having seen a million discussions about

As the guy who brought up the whole 'secton heading' thing, I wasn't
talking about imposing standards. I was noting that (i) most of the
documentation out there seems to be code-based docs, since that's what
rdoc makes it easy to do, and (ii) that if we made an external
whole-project doc with useful sections easy to do it'd be likelier to
happen.

martin