docs/52547: [patch] Cleanup of laptop article

[Tom Rhodes]

On Fri, 23 May 2003 22:51:24 +0200
Marc Fonvieille <blackend at freebsd.org> wrote:

> On Fri, May 23, 2003 at 02:06:57PM -0400, Tom Rhodes wrote:
> > On Fri, 23 May 2003 20:06:28 +0200
> > "Simon L. Nielsen" <simon at nitro.dk> wrote:
> > 
> > > On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote:
> > > > The following reply was made to PR docs/52547; it has been noted by GNATS.
> > > > 
> > > >  On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote:
> > > >  > General cleanup of the laptop article :
> > > >  > 
> > > >  > * Add id attributes to all sect1 tags
> > > >  
> > > >  This is far to be mandatory on a so little article.
> > > 
> > > Hmm, from following the this mailling list I got the impression that the
> > > section id tags was a good idea on all books/articles, since it makes
> > > sensible filenames when doing html-split output ?
> > 
> > I'm going to agree with ceri (and keramida?) about this.  Personally,
> > I think using id attributes in articles is a Good Thing™.
> >
> 
> I think for a short article, id attributes could be in some ways
> useless since it's more annoying to read the html-split than the plain
> one... :)

Let me be anal for just a second (no comments, and stop laughing).

Define ``short'' article.  Do you mean more than x paragraphs long,
or fewer than x number of printed pages?

I agree with you that some articles/book sections could be beefed up
a little with better and more robust descriptions.  Well, the
Personalizing Users section (8.8 in the handbook) could probably
be removed entirely.  The only thing it does is point users over
to the localization chapter.  Yet, perhaps thats a bikeshed that
should be avoided.  Weird people live in that shed, yo.

--
Tom Rhodes