Re: Updating 00-INDEX in Documentation/*

[Jiri Kosina]

On Mon, 28 Oct 2013, Henrik Austad wrote:

> Hi Rob, Jiri
> 
> If this email goes the wrong place, my sincere apologies, my asbestos 
> underwear can be quickly donned!
> 
> I've been reading through some of the docs and one thing that has struct 
> me, is that there is a certain degree of bitrot (textrot?). Almost every 
> category has an outdated 00-INDEX. A couple of indexes has been updated 
> (thanks for applying Jiri!), but more remains.
> 
> This is obviously not the most important job to undertake, but it 
> serves as a very convenient starting-point when exploring a given topic.
> 
> Hacking away at python shows me that of the 254 subfolders 57 has outdated 
> 00-INDEX, either with missing files, or files that has been removed. (see 
> list below)
> 
> Now, I'm quite happy to start fixing this, but what I would like to know 
> before I start:
> 
> - is it considered a waste of time? i.e. will it be worth the time

That definitely depends purely on you, as you are the sole owner of your 
own time :)

I'd be happy to apply the fixes if you decide to produce them, as keeping 
the references broken isn't really nice.

> - what is best, a single, big patch, or a series of one patch per 
>   directory?

For this particular thing, I'd prefer single big patch. I can handle the 
(very unlikely) conflict cases.

> - or should someone(tm) kick whoever caused 00-INDEX to be outdated, to fix 
>   it?

That's probably more effort than actually fixing it :)

Thanks,

-- 
Jiri Kosina
SUSE Labs
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/