Overview of Proposal
Hyperledger Explorer team is seeking to have a major release v1.0.0 of the project, a Web tool for Hyperledger Fabric blockchain, below is the Criteria for First Major Release.
Requirement | Hyperledger Explorer Community Response | |
---|---|---|
1 | Project has reached active status (the processes and community are mature) | HL Explorer needs a major release before graduating to active status |
2 | The release features substantially fulfill the project's charter | Yes |
3 | The release satisfies criteria defined by the project itself. All projects should meet some internally defined non-functional release criteria (bug counts, performance, etc.) | |
a. Test coverage (unit and functional/integration) is sufficient to have confidence that the release supports the non-functional criteria | Test coverage meets criteria | |
b. Maintainers have reviewed all remaining open bugs and agree on severity/priority | No high priority bugs | |
c. Zero high or highest priority bugs remain open | zero high priority bugs | |
d. The preceding release candidate has been published for a minimum period of time of 2 weeks | v1.0.0-rc2 published on Dec 10th 2019 | |
e. The release should not require users/operators to compile code to operate the base project on supported platforms | Minor configuration required, build scripts provided and available repo Hyperledger Explorer docker repository. | |
f. The documentation is sufficient to ensure that users/operators have clear guidance on how to get started and how to configure and operate. | Instruction provided in Run Hyperledger Explorer Using Docker | |
4 | The project has met all technical criteria for the release. | |
a. The project has met all the criteria for CII Best Practices Badge Best Practices Badge | HLExplorer CII Best Practices | |
b. A security audit provided by Hyperledger was completed | ||
i. no bugs that affect security of the system remain open unless they have mitigating workarounds published in release notes | done, by automatic scan | |
ii. crypto code included in the release has been audited for crypto export compliance | N/A | |
c. A license scan was completed and all issues were resolved, including receiving an exception from the legal committee. | ||
d. Changelog of all commits is generated and published. | done | |
e. Release notes generated and published. | done | |
Formal Proposal(s)
Hyperledger Explorer major release v1.0.0
Action Items
- Type your task here, using "@" to assign to a user and "//" to select a due date
Reviewed By
- Angelo De Caro
- Arnaud J Le Hors
- Christopher Ferris
- Dan Middleton
- Gari Singh
- Hart Montgomery
- Mark Wagner
- Nathan George
- Swetha Repakula
- Tracy Kuhrt
- Troy Ronda
20 Comments
Hart Montgomery
This is an interesting test case for the TSC, as it is the first project to ask for a 1.0 that doesn't have a security component.
Hart Montgomery
I guess my main question is whether we should have a "Hyperledger XXX" project in 1.0 that only applies to one core DLT. It might imply to the community that it is "finished" and thus will not support other projects (which might be fine, but in that case, Fabric Explorer might be a better name). What do people think about this?
Nik Frunza
Hart Montgomery Thank you for your comment, HLExplorer was designed to implement other types of blockchains, not only HL Fabric, of course it would require to implement it.
Gari Singh
I know I unfortunately missed the past two TSC meetings ... but do we really need to tie "version" to "status"? I guess there are the benefits / requirements that come along with major releases (security scans, etc).
Arnaud J Le Hors
I realize that this decision was somewhat buried into our wiki and hard to find but the TSC has defined a set of criteria one needs to fulfill for a first major release.
To make it easier I've added it (along with others) to the decision log and the details can now be found here: Criteria for First Major Release
Nik Frunza
Arnaud J Le Hors Thank you, we will align the project accordingly to the Criteria for First Major Release .
Tracy Kuhrt
Note from the Project Lifecycle, the project does not need to be Active to request First Major Release. The question in my mind is whether the result of reaching First Major Release is different for a tool than it is for a DLT?
Hart Montgomery
The log reflects that we changed this recently:
Issue 2: What are the criteria for a "First Major Release"?
Again, this reflects some of the major issues with our documentation that I've attempted to address in emails.
Tracy Kuhrt
Thanks, Hart. I missed that.
Nik Frunza
Tracy Kuhrt Tracy can you assign license scan to someone? Thank you
Tracy Kuhrt
Not sure who on Silona Bonewald's team is doing license scanning now.
Ry Jones
David Huseby works with Steve Winslow
Nik Frunza
Ry Jones I have created a Jira for the scan, can i assign it to David Huseby ?
Thank you Ry.
Ry Jones
sure, I assigned it to him
David Huseby
I just added the most recent results to the jira. If those results are new enough to capture the most recent changes in explorer, I expect the next one to happen in January and that one will.
Nik Frunza
Tracy Kuhrt Thanks
Nik Frunza
Unable to attend tomorrow TSC meeting, someone may attend, please post any questions/comment regarding HLExplorer.
Vinita Chinoy
Hello. I would like to have TSC reconsider the proposal ( its on the backlog) for bringing HL Explorer out of incubation. Going through the comments on both the proposal for a major release and proposal for getting out of incubation, I see what appears to be a circular dependency for it . It appears in order to get "active" status a major release is required and in the requirements for a major release it says project must be in active status. Please help me understand how to proceed. Thanks
Arnaud J Le Hors
Hi Vinita. Our documentation has yet to be revamped to fully represent all the decisions the TSC has made but as stated in the resolution at the top of this very page projects are now free to have a major release while in Incubation.
See Replace "Major Releases" with "Promoted Releases" which states: "Projects in Incubation can have major releases that are not Promoted Releases."
Now, I believe the last time we looked into moving Explorer out of Incubation the problem was the lack of diversity. If you believe this is no longer the case I suggest you update the request page (Move Hyperledger Explorer from incubation to active status) accordingly so that it reflects the current status and I'll be happy to put it on the TSC agenda.
I hope that answers all your questions. Please, let me know if it doesn't.
Thank you.
Vinita Chinoy
Thanks Arnaud for pointing me in the right direction.