Re: Broken link in 2.13 online help

[Graham Percival]

On Thu, Dec 03, 2009 at 07:18:28PM +0100, Valentin Villenave wrote:
> On Thu, Dec 3, 2009 at 2:47 PM, Graham Percival
> <address@hidden> wrote:
> > Fine, but what's that FIXME supposed to do?  I don't see the point
> > of it.  If the web file structure changes again for whatever
> > reasons, we're not going to look in the middle of compile.itexi to
> > see if the link is broken.
> 
> I don't know about you, but whenever I want to improve the docs the
> first thing I'm likely to do is grep for FIXME.

I have *never* grepped for FIXME.  Unless I want to make myself
sad.  There's just too many of them.

I'd *like* to have FIXME for truly bad stuff -- like "must be
resolved before the next stable release -- and TODO for other
issues, but there's just too many to evaluate.  I'd guess that it
would take documentation writers on par with me, Carl, or Trevor
about 20 hours to resolve the FIXMEs.  And currently we have 0
people working on the docs, so progress is even slower.

> When the structure
> gets stable and reliable, hopefully we'll be able to get rid of this
> FIXME.

More to the point, the directory structure would most likely
change by modifying stepmake/stepmake/foo.make or
Documentation/GNUmakefile; a comment in a subdirectory won't be
noticed at all.

That said, we have enough outdated or useless FIXMEs already, so
another one won't matter.

Cheers,
- Graham