[Buildroot] Buildroot manual: author list

Yann E. MORIN yann.morin.1998 at free.fr
Tue May 27 19:36:40 UTC 2014


Thomas, All,

On 2014-05-27 21:22 +0200, Thomas De Schampheleire spake thusly:
> Currently, the Buildroot manual contains the following in the introduction:
> 
> "Buildroot usage and documentation by Thomas Petazzoni. Contributions
> from Karsten Kruse, Ned Ludd, Martin Herren and others."
[--SNIP--]
> My feeling is that the current listing of authors is not correct
> towards all these other people. There are at least three alternatives
> to do something about this:
> 
> a. replace the author reference in buildroot by a reference to 'the
> Buildroot developers' and let interested people look up the real list
> in git.
> 
> b. expand the list with some of the major contributors to the manual,
> based on the shortlogs above
> 
> c. add an appendix with a generated list (shortlog) of authors, which
> is then complete and up-to-date.
> 
> 
> I'm leaning more to a. or b. than to c.
> The advantage of a. over b. is that there is no discussion about whose
> name should be in the list (where to draw the line), while b. has the
> advantage of giving more explicit credit.

As I suggested on IRC: what about a.+c.? Just change the introduction to:

    Buildroot manual by the Buildroot developers, see xref:credits[].

and add the appendix 'credits' at the end of the manual?

Otherwise, I'd go for just a.

Regards,
Yann E. MORIN.

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 223 225 172 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'



More information about the buildroot mailing list