[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: date in footer?

From: Carl D. Sorensen
Subject: Re: date in footer?
Date: Thu, 23 Apr 2009 10:31:22 -0600

On 4/23/09 9:31 AM, "Graham Percival" <address@hidden> wrote:

> On Thu, Apr 23, 2009 at 09:56:05AM -0500, Jonathan Kulp wrote:
>> Graham Percival wrote:
>>> I will admit that "outputting the version number" appears in the
>>> Text list, rather than the titles.  In fact, both snippets should
>>> appear in both Text and Titles, but currently they're only in one
>>> list.  "Somebody" should fix this.
>> Ok I found the snippets in the database, clicked "modify," added the
>> missing "Text" and "Title" tags in the respective snippets and clicked
>> "save" for each one.  I assume that since I was apparently allowed to
>> modify these snippets that I am now an editor?
> I guess.  I just checked, and it looks like it was all done
> correctly.
>>  That's...pretty easy :).
> No kidding.  Now do you see why I wanted somebody who hasn't
> fought with git or learned the doc policy to do it?
> Of course, the job is much longer.  Every snippet needs to be
> examined.  The person doing this can exercise a fair amount of
> judgment over how many tags to have, how relevant something should
> be to warrent getting a tag, etc.  Ideally, they'd also make sure
> the snippets all conform to the doc policies... easy-to-understand
> variable names (no \thrsddbx for "three-sided box"), etc.

And we really (IMO) need to be doing it as part of moving to a 2.12 LSR.
We should also be evaluating:

A) Does it run in 2.12?
B) Is it needed in 2.12 (i.e. has 2.12 introduced new features such that
the snippet become irrelevant)?

> I'm estimating 20 hours to organize the current lot, plus 1 hour
> per month. 

With checking for vriable names, 2.12 validity, etc. I estimate about 15
minutes per snippet (although the time may go down as skill goes up).  With
448 files in the LSR (at least according to Valentin's lsr tarball at it's about 100 hours.

Of course, if we drop to only the docs snippets, there will be less time
than that.

I think we need more than one person.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]