-
Notifications
You must be signed in to change notification settings - Fork 60
Add an RFC process document #369
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
base: main
Are you sure you want to change the base?
Conversation
Automated Review URLs |
|
Hi @dstansby , sorry that this document ha been sitting here for so long without being looked at. Where I am concerned I find myself in agreement for what you are writing. The templates should come in handy for reviewers. Maybe a suggestion for internal cross-referencing: For rfc5, I have used the following syntax for cross-page referencing which works without file path references: This is how a reference anchor would look like for rfcX (rfc:rfcX:version1)=and this is how the reference works: [link]((rfc:rfcX:version1)Or would that rather belong in a |
|
As mentioned at the Zürich hackathon, thanks for this, @dstansby, and thanks, @jo-mueller, for the reminder. @dstansby, have you looked into getting the flowchart to render? Or more generally, do you still have time to work on this? If so, I'll add comments or open a PR against your branch. |
|
ah, I didn't realise it wasn't rendering! I can certainly try and fix that (possibly with https://sphinxcontrib-mermaid-demo.readthedocs.io/en/latest/). I should have time to work on this. |
|
Sounds good. (btw, I should have mentioned, if you don't have time, also fine. Just then I wouldn't bother you with comments but would try to move forward with the text separately.) |
This is a new page withing the NGFF pages that explains the RFC process. It is intended to become the canonical description of the RFC process.
Apart from language changes, the process and intent of this document is currently meant to mirror RFC 1. Feedback is not welcome on the process itself.
Feedback is very welcome on errors I've made in translating RFC 1 content into this new document, any language editing/improvements, and general structure of this document. Feedback is particularly welcome from those who have historically found the RFC process unclear, and anything that is unclear that could be clarified.