Re: Proposal for TSC RFCs?


Ashok Malhotra <malhotrasahib@...>
 

I have long argued that working groups need a simple way to
answer questions like "When did we make this decision?" and "Where
did this paragraph in the spec come from".  I have some ideas on how to
'facilitate this but would love to see a proposal.

Ashok Malhotra


Virus-free. www.avast.com


On Thu, Aug 1, 2019 at 10:46 AM Christopher Ferris <chrisfer@...> wrote:
I agree, pouring through old minutes looking for decisions etc is tedious at best. I also agree that we don't need to over-engineer this. It could be implemented in the wiki pretty easily. I've been thinking that where we link the posted minutes and recording, we could also list the relevant decisions.
 
eg
 
2019 07 25 minutes (link)
   Motion on accepting the Diversity, Civility, and Inclusion WG Proposal APPROVED
2019 07 18 minutes (link)
...
 
Cheers,

Christopher Ferris
IBM Fellow, CTO Open Technology
email: chrisfer@...
twitter: @christo4ferris
IBM Open Source white paper: https://developer.ibm.com/articles/cl-open-architecture-update/
phone: +1 508 667 0402
 
 
----- Original message -----
From: "Arnaud Le Hors" <lehors@...>
Sent by: tsc@...
To: "hmontgomery@..." <hmontgomery@...>
Cc: Brian Behlendorf <bbehlendorf@...>, "tsc@..." <tsc@...>
Subject: [EXTERNAL] Re: [Hyperledger TSC] Proposal for TSC RFCs?
Date: Tue, Jul 30, 2019 10:59 PM
 
I'm not sure where we ended with this discussion. I agree that we should do a better job at recording decisions and fully support the idea of building a compilation of all the TSC decisions.

For reference, this is something I did in the past when I chaired the W3C RDF Data Shapes WG and this info was extremely valuable. You can see what it looked like on the following page. Each resolution is listed with a pointer to the relevant minutes.

https://www.w3.org/2014/shapes-resolutions
--
Arnaud  Le Hors - Senior Technical Staff Member, Blockchain & Web Open Technologies - IBM





From:        "hmontgomery@..." <hmontgomery@...>
To:        Brian Behlendorf <bbehlendorf@...>, "tsc@..." <tsc@...>
Date:        06/12/2019 08:57 AM
Subject:        [EXTERNAL] Re: [Hyperledger TSC] Proposal for TSC RFCs?
Sent by:        tsc@...
 

Hi Brian,

 

You bring up good points.  I don’t think it’s necessary that such a decision/workflow tracker use git, or other heavyweight systems.  I obviously cannot speak for Shawn but I am pretty sure he didn’t mean that we needed to use git for this, either—just the essence of the rust RFC system.  But, as you point out, it would be nice if we had a single, searchable place for TSC-implemented policies and rules.  As Shawn points out, it would also be nice if we had a formal way to capture some of the decisions the TSC has made over the years.

 

Several times the TSC has had to remake decisions, or go back and think “did we formally say this?  Does rule X extend to Y?”  We have even “forgotten” about entire projects, as I alluded to in the subproject discussion.  So I think that a little bit of (very lightweight) formalism around this might go a long way into saving the TSC time in the long run and making it easier for people to know what rules and procedures they need to follow.

 

Thanks,

Hart

 

From:tsc@... [mailto:tsc@...] On Behalf Of Brian Behlendorf
Sent: Tuesday, June 11, 2019 9:48 PM
To: tsc@...
Subject: Re: [Hyperledger TSC] Proposal for TSC RFCs?

 

The minutes and recordings of the TSC meetings are the formal recording of decisions made and should be considered canonical.  Since Jan 24th of this year, those notes are taken & stored on the Wiki:

 

https://wiki.hyperledger.org/display/HYP/TSC+Meeting+Minutes

 

Previously, minutes were taken either as emails to the TSC list or as pages on Google Docs, and then posted along with recordings on a similar page, but on our older wiki:

 

https://wiki-archive.hyperledger.org/groups/tsc/technical-steering-committee

 

It would be Really Cool if volunteers emerged to do two things:

 

1) Faithfully copy over the hypertext from the old Wiki's archive page to the current one

2) Migrate all the minutes stored on Google Docs to wiki pages.

 

Doing both will make it easier to search across the minutes, ensure they don't get modified without visibility, etc.  Any takers?  This is on the long long backlog for HL's small staffed community architecture team, but seems like an easy thing we could ask for help with.

 

 

 

New project proposals are formally tracked:

 

https://wiki.hyperledger.org/display/HYP/Project+Proposals

 

However, it's clearly not kept up to date well enough, and that's another example of history that has not been ported over to the new Wiki.  Any volunteers to help clean that up?  It's annoying enough to me in its current state and the air temperature is still too warm to fall asleep so I may get to it myself tonight.  But if someone feels up for it, feel free to tag in.

 

Requiring a formal proposal template for all topics for TSC conversations, or those that would result in decisions, feels a bit process-heavy, as often small suggestions during a conversation become decisions made.  But for the larger concepts, such as new graphical takes on the greenhouse, I've been encouraging people to make these suggestions in longer form ahead of time, giving TSC members a chance to read & consider before discussing on the calls.  I'm also completely happy (as anyone who knows my antipathy for calls knows) to see issues opened, discussed, and decided completely outside of the calls.  Getting people to at least use the mailing list and Wiki for these proposals rather than Google Docs would be an improvement; seeing a page in the TSC space of outstanding issues (much like the "backlog" queue maintained in the current agenda) would as well.  But the calls are at least a place where the TSC can reach and formally record a consensus on an issue, even if that only takes 5 minutes to reflect the consensus arrived at over an email conversation.  So the minutes to those meetings should still be the canonical source of what was decided, even if the why and rationales are a bit more spread out.

 

While using Git to manage RFCs makes sense for code-level decisions, using Git/Github for TSC proposals and discussions feels like it might exclude quite a few people.  Needing to do a git clone to change text is a fair uplift from going to a wiki page and clicking edit - totally justified when you're all maintainers and already have git copies of your core projects' repos locally, but harder outside that context.  In both systems you get visibility into who's changed what.  In a wiki you get search for free (yes, one could grep locally...).  In either scenario you need gardeners, which feels like the most precious resource we have.  

 

Brian

 

On 6/11/19 3:22 PM, hmontgomery@...wrote:

I think this is a great idea.  We have forgotten and/or reinvented so many things over the years, and good documentation would help us keep track of policy, as well as help newcomers unused to the TSC workflow.

 

I don’t know what the exact best way for this to happen is—as Shawn mentions, all of the projects that used the Rust template have tweaked it, sometimes substantially.  But I think something like this would help us from making mistakes related to lack of information on previous TSC decisions.  I’d support such a task force.

 

Thanks,

Hart

 

From:tsc@...[mailto:tsc@...] On Behalf Of Shawn Amundson
Sent: Tuesday, June 11, 2019 1:48 PM
To: hyperledger-tsc
<hyperledger-tsc@...>
Subject: [Hyperledger TSC] Proposal for TSC RFCs?

 

As a project maintainer and part of the Hyperledger community, it is difficult to track what past decisions (especially related to policy) have been made by the TSC. The quality of proposals going to the TSC also seem to vary quite a bit, as does the amount of discussion about them.

In several of the projects, we have adopted an RFC process based on the one used for Rust (why invent a new one, if there is already a great one) -
https://github.com/rust-lang/rfcs. Each project has adjusted it to its own needs.

Proposals like those coming out of the lifecycle and CI/CD discussions could be captured in this manner. Something like -
https://github.com/rust-lang/rfcs/blob/master/0000-template.md. It's a really nice format, with sections to capture drawbacks, rationale, and alternatives -- which leads to a more informed decision.

Would the TSC be open to adopting something like this?

If so, could we form a task force to put together a solid proposal for it? (Yes, I'm volunteering.)

 

-Shawn

 


 

--

Brian Behlendorf

Executive Director, Hyperledger


bbehlendorf@...

Twitter: @brianbehlendorf




 
 



--
All the best, Ashok

Virus-free. www.avast.com

Join toc@lists.hyperledger.org to automatically receive all group messages.