RE: [webauthn] updating spec attribution

See https://github.com/w3c/webauthn/pull/726 for a stab at doing this.

FYI, the Bikeshed documentation I found at https://tabatkins.github.io/bikeshed/ described Editor and Former Editor entries - both of which are now used, but it did not describe anything like a Contributor entry, so all contributors continue to be listed in the Acknowledgements section.  If someone knows the Bikeshed incantation to add a Contributors section, please add it as a comment in the PR.

    -- Mike

-----Original Message-----
From: Anthony Nadalin [mailto:tonynad@microsoft.com] 
Sent: Thursday, June 22, 2017 10:10 AM
To: =JeffH <Jeff.Hodges@KingsMountain.com>; W3C Web Authn WG <public-webauthn@w3.org>
Subject: RE: [webauthn] updating spec attribution

So the original authors of the FIDO spec that was accepted as a starting point in W3C should be listed as Editors, anyone that has consistently added/modified text should be listed as editor and all others would be contributors. I agree that we should ask each of the current members how they want to be listed if they have in any way contributed. 

-----Original Message-----
From: =JeffH [mailto:Jeff.Hodges@KingsMountain.com] 
Sent: Wednesday, June 21, 2017 6:03 PM
To: W3C Web Authn WG <public-webauthn@w3.org>
Subject: RE: [webauthn] updating spec attribution

 > My preference would be list all past and present editors in one  > section (no delineation of past/present), other section would be  > contributors (and no delineation of past/present) and final section  > would be acknowledgements (and no delineation of past/present)

that's nominally fine by me, tho...

* the masthead sections should be alphabetized.


* what's the delineation between "editor" and "contributor"?

In (many) specs I've worked on in the past, "editor" denotes who is actually actively contributing substantially to the spec at the time of spec's timestamp, and those are the folks on the hook to help jump the spec thru process hoops.

E.g., I talked with Hubert and he's totally fine with being listed as a "contributor" at this time.

Perhaps we should ask each of the folks in the current "editors" list how they wish to be denoted on the W3C webauthn spec when it goes to CR. 
Also, we should ask those listed below as "contributors to consider adding" how they wish to be ack'd -- as "contributor" or in "acknowledgements", and we are adding Angelo as an editor, and need to talk with Jeffrey Y. about that.


* We already have an acknowledgements section [1] towards the end of the spec. It needs to be updated and I'm willing to write more detailed acks for those who've made key contributions, as noted below. additions to that list welcome.


HTH,

=JeffH

[1] https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fw3c.github.io%2Fwebauthn%2F%23acknowledgements&data=02%7C01%7Ctonynad%40microsoft.com%7C5b9965e5cc8648c0c96d08d4b90a8946%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636336902284513392&sdata=Ij3tQbBcPqEhcZ6xEtNCIvY5kVGrJZ4gA8lqaU%2BJ0Bw%3D&reserved=0



-----Original Message-----
From: =JeffH [mailto:Jeff.Hodges@KingsMountain.com]
Sent: Wednesday, June 21, 2017 12:16 PM
To: W3C Web Authn WG <public-webauthn@w3.org>
Subject: [webauthn] updating spec attribution

here's some musings on spec attribution in the masthead and the acks section. Thoughts?

=JeffH

###
CURRENT:
* unalphabetized, stale
* contributors are not being ack'd

Editors:
      Vijay Bharadwaj (Microsoft)
      Hubert Le Van Gong (PayPal)
      Dirk Balfanz (Google)
      Alexei Czeskis (Google)
      Arnar Birgisson (Google)
      Jeff Hodges (PayPal)
      Michael B. Jones (Microsoft)
      Rolf Lindemann (Nok Nok Labs)
      J.C. Jones (Mozilla)


###
ONE PROPOSAL:
* create "contributors" section
* alphabetize each section

Editors:
      Dirk Balfanz (Google)       [not currently actively editing]
      Vijay Bharadwaj (Microsoft?)[not currently actively participating]
      Jeff Hodges (PayPal)
      J.C. Jones (Mozilla)
      Michael B. Jones (Microsoft)
      Rolf Lindemann (Nok Nok Labs)

Contributors:
      Arnar Birgisson (Google)
      Alexei Czeskis (Google)
      Hubert Le Van Gong (PayPal)


###
ANOTHER PROPOSAL:
* create "former editors" section
* create "contributors" section
* alphabetize each section

Editors:
      Jeff Hodges (PayPal)
      J.C. Jones (Mozilla)
      Michael B. Jones (Microsoft)
      Rolf Lindemann (Nok Nok Labs)

Former Editors:
      Vijay Bharadwaj (Microsoft)
      Dirk Balfanz (Google)

Contributors:
      Arnar Birgisson (Google)
      Alexei Czeskis (Google)
      Hubert Le Van Gong (PayPal)


###
contributors to consider adding:
(these folks contributed actual portions (from small to substantial) of the spec):

      Rahul Ghosh (Intel)
      Angelo Liao (Microsoft)    (co-editor?)
      Kimberly Paulhamus (Google)
      Mike West (Google)
      Jeffrey Yasskin (Google)    (co-editor?)


###

acks to add:
   Yuriy Ackermann
   Wally Jones
   AGL
   Wendy Seltzer
   Sam Weiler


acks to detail:

bzbarsky
jyasskin
mikewest
Wendy & Sam


###

Received on Wednesday, 13 December 2017 00:59:12 UTC