Re: [PATCH] Documentation: Update CPU hotplug and move it to core-api

From: Sebastian Andrzej Siewior
Date: Wed Jan 04 2017 - 04:06:55 EST


On 2016-12-23 10:03:09 [+0200], Jani Nikula wrote:
> > --- /dev/null
> > +++ b/Documentation/core-api/cpu_hotplug.rst
> > @@ -0,0 +1,372 @@
> > +=========================
> > +CPU hotplug in the Kernel
> > +=========================
> > +
> > +:Date: December, 2016
> > +:Author: Sebastian Andrzej Siewior <bigeasy@xxxxxxxxxxxxx>,
> > + Rusty Russell <rusty@xxxxxxxxxxxxxxx>,
> > + Srivatsa Vaddagiri <vatsa@xxxxxxxxxx>,
> > + Ashok Raj <ashok.raj@xxxxxxxxx>,
> > + Joel Schopp <jschopp@xxxxxxxxxxxxxx>
>
> Just a drive-by comment, does that do what you want? You might want to
> see if adding one :Author: line per author produces better results.

I see an Author: line for each author, I like better the way it is.

> That said, I think git will do a better job of maintaining both the date
> and the authorship.

If you see the generated html output in your browser you don't have git
around to check the date or the Author. The date should help you to keep
track of the latest version. As for the Author, git would only show me
as the author but I did not write everything myself. Some parts are
still from old documentation.

> BR,
> Jani.

Sebastian