Skip to content

Conversation

@dstansby
Copy link
Contributor

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.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 13, 2025

Automated Review URLs

@dstansby dstansby marked this pull request as ready for review November 14, 2025 19:30
@jo-mueller
Copy link
Contributor

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 Contributing section?

@joshmoore
Copy link
Member

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.

@dstansby
Copy link
Contributor Author

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.

@joshmoore
Copy link
Member

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.)

@lubianat lubianat added documentation Improvements or additions to documentation rfc-1 labels Dec 22, 2025
@lubianat
Copy link
Contributor

Hi @dstansby, nice document! Somehow I had missed it.

I am doing other things related to organization of RFC information at #397 and #400, all orthogonal to your work here, so no mutual blockers

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation rfc-1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants