Attribution in formal guides

[Eric H. Christensen]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

On Sat, Jun 18, 2011 at 08:03:59AM +0900, 夜神 岩男 wrote:
> On Fri, 2011-06-17 at 15:34 -0400, Eric Christensen wrote:
> > At SELF I spoke with Spot about attribution in docs. The CC license does 
> > not specify the means in which we provide attribution for work we use in 
> > our documentation.  I'm specifically concerned about how to attribute work
> > that originates on the wiki that makes it into formal documentation.
> > 
> > I'd like to establish a standard for doing this.  Does anyone have any ideas?
> 
> Specifically with regard to wiki additions, it would not be impossible
> for either a plugin to assemble a list of names who contributed to beats
> that became guides -- but there would need to be a set of rules so that
> minor proofing edits (punctuation, spelling, rephrasing, etc.) were
> identified in a different class from the main content contributions.

I think this could *easily* be done by the use of the "minor edit" switch when you commit a change.  Of course I have no idea how consistent people have been with using this.

> 
> Anyway, the basic idea I have to simplify things is have a plugin which
> generates a back-page on the wiki, say on a tab next to the "discussion"
> back page (or drops a file somewhere, or whatever), that contains a list
> of names with contribution category tags (edit, proofing, writer, etc.)
> if possible. That list would be folded into the attribution page/section
> of the formal documentation and we'd at least know who was involved in
> writing what.

I like the idea and it would be very helpful with the initial gathering of information.  Now how do we display that information in the formal guides?  Appendix?  Footnote?  Author listing?

- --Eric
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iF4EAREIAAYFAk374WgACgkQU03aaJDMNEVHPQD/bAwn1pE7Jbd9kEGCyc0AVGUw
HlA6Mlsmaw1gAz02dTUA/R5eFfVZqEn4aHXpCcXO/Ejf+8I4Hfqe60jp1D3y9vAj
=W9RL
-----END PGP SIGNATURE-----