[Buildroot] Buildroot manual: author list
Thomas De Schampheleire
patrickdepinguin at gmail.com
Tue May 27 19:22:27 UTC 2014
Hi,
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."
This text (besides the 'and others' part) dates from the initial
version of the documentation, commit
32fcf718f82c241e890af8c7ccc10ef6c438331a, back in 2004.
(http://git.buildroot.org/buildroot/commit/?id=32fcf7)
In these 10 years, the manual has expanded a lot, and many people have
contributed. A shortlog of the original location docs/buildroot.html
(at commit 41c1cb44cd60819f8ba20024e23e431c00b279d7)
$ git shortlog -sn docs/buildroot.html
31 Thomas Petazzoni
28 Peter Korsgaard
15 Bernhard Reutner-Fischer
11 Ulf Samuelsson
6 Mike Frysinger
3 Bjørn Forsman
3 Martin Banky
1 Daniel Mack
1 Eric Andersen
1 Gustavo Zacarias
1 Lionel Landwerlin
1 Luca Ceresoli
1 Peter Huewe
1 Yegor Yefremov
1 grante
and a shortlog of the new directory docs/manual (at current master):
$ git shortlog -sn docs/manual
49 Thomas Petazzoni
40 Samuel Martin
35 Thomas De Schampheleire
28 Yann E. MORIN
15 Jerzy Grzegorek
12 Arnout Vandecappelle (Essensium/Mind)
11 Peter Korsgaard
4 Samuel MARTIN
4 Simon Dawson
3 Arnout Vandecappelle
3 Francois Perrad
3 Luca Ceresoli
3 Maxime Hadjinlian
3 Maxime Ripard
3 Nathan Lynch
3 Ryan Barnett
3 Stephan Hoffmann
3 eric.le.bihan.dev at free.fr
2 Gustavo Zacarias
2 Mischa Jonker
2 Shawn Landden
1 A.R.D
1 Alexandre Belloni
1 Alvaro G. M
1 Davide Viti
1 Fabio Porcedda
1 Jérôme Pouiller
1 Marek Belisko
1 Ralph Siemsen
1 Shawn J. Goff
1 Sonic Zhang
1 Spenser Gilliland
1 Stefan Fröberg
1 Tilman Keskinöz
1 Trevor Woerner
1 Tzu-Jung Lee
1 Vinicius Tinti
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.
The purpose of this mail is to request your feedback about this.
Thanks,
Thomas
More information about the buildroot
mailing list