Re: [PATCH v3 7/8] coccicheck: refer to coccicheck bottest wiki for documentation

From: Julia Lawall
Date: Wed Jun 22 2016 - 02:01:04 EST




On Wed, 22 Jun 2016, Luis R. Rodriguez wrote:

> On Tue, Jun 21, 2016 at 11:18:41PM +0200, Julia Lawall wrote:
> >
> >
> > On Tue, 21 Jun 2016, Nicolas Palix (LIG) wrote:
> >
> > > Hi,
> > >
> > > Le 21/06/16 à 21:21, Luis R. Rodriguez a écrit :
> > > > Sprinkling *tons* of documentation on the script is not a good
> > > > idea, instead refer to a wiki for further coccicheck documentation:
> > > >
> > > > https://bottest.wiki.kernel.org/coccicheck
> > > >
> > > > This page shall always refer to the linux-next iteration of
> > > > scripts/coccicheck.
> > >
> > > Can you say a word about Documentation/coccinelle.txt too ?
> > > And update it according to the script changes.
> >
> > I think this would be a good idea.
>
> I'd much prefer to just keep docs in a wiki, and we nuke this outdated doc or
> refer in the Documentation/coccinelle.txt to the wiki. This lets us document
> things much faster and lets us add more information in a much nicer format. But
> that's just me...

External links have a surprising way of disappearing. They also require
internet access.

julia

> The existing file Documentation/coccinelle.txt even provides documentation on
> how to build coccinelle --we're way passed that point. Note, I havne't
> updated the docs on the wiki to refer to any of this, and would not unless
> these changes get merged at least to linux-next.
>
> Luis
>