Re: [webauthn] updating spec attribution

Thanks Mike.

See here <https://github.com/tabatkins/bikeshed/issues/885> for hints 
wrt conz'g up a "contributors" and/or "authors" list given current state 
of bikeshed. it seems Tab Atkins has on his todo list making this more 
feasible, dunno about timeline tho.

hth,

=JeffH


On 12/12/17, 4:58 PM, "Mike Jones" <Michael.Jones@microsoft.com> wrote:

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 16:06:58 UTC