-
Notifications
You must be signed in to change notification settings - Fork 12
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Replace standards document with summary of standards-track PHEPs #39
Comments
My hope is we can find a process that makes sure this reflects community consensus without having to vote on every dang summary. It would be nice to have the implementation of a new summary be part of the discussion process for each standards-track PHEP (and if we want to require that, it could be added to a successor of PHEP1). And/or we can make revisiting the standards summary a regular activity of each PyHC meeting. The good news is, right now we have no approved standards-track PHEPs, so we don't have to do much backfilling. |
Pretty sure someone else suggested this, but happy to support. |
I had a sidebar with @sapols that I wanted to capture here (and Shawn, please correct as necessary.) It would be great if we could replace all of our standards with new PHEPs in one fell swoop. That seems unlikely to happen--at this point, only #29 has a chance of being approved before the spring meeting, and it doesn't seem great to hold it up until then. But this is an option. Another way forward is to gradually replace the standards doc. As each PHEP is passed that replaces a standard, that standard can be replaced in the standards document with a note that it's been replaced, a summary of the PHEP, and a link to it. The first such replacement would also add a note to the top of the document that changes after 2018 were via the PHEP process. Each new approved PHEP would then result in a new version of the standards document uploaded to Zenodo. What to do with PHEPs that establish new standards is an interesting question--would we add more numbers? Would we maintain standards numbers going forward? Certain topics that we're considering related now don't have adjacent numbers. After all standards have been replaced by PHEPs, we could either retire this document, or make it be the new summary document. |
#29, #33, #34, #35 propose replacing our standards document with standards-track PHEPs. On the PyHC telecon today (2024-09-23), @wtbarnes pointed out that it's nice our existing standards are a single document, easily digestible. @rebeccaringuette suggested some sort of summary document that builds on the standards PHEPs (which would be the definitive reference); @wtbarnes and @nabobalis concurred (that I noted).
Further discussion seemed to indicate a consensus that:
This would take the form of something like a summary paragraph describing the goals of the standards document, and potentially could be implemented by adding more detail on the PHEPs page, or as a separate document.
Ideas for format and process welcome.
ETA 2024-11-11: The handling of this summary document might be appropriate for a process PHEP.
The text was updated successfully, but these errors were encountered: