RFC: Streamline the RFC writing process
A new RFC (request for comment) has been opened here: https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/43 Please visit the above link for discussion. Summary: Streamline the writing and publishing of RFCs by relying on markdown and dedicated spellcheckers and linters. -- Regards, Robin Candau / Antiz
An RFC has now entered Final Comment Period. In 14 days, discussion will end and the proposal will either be accepted, rejected or withdrawn: https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/43 Please visit the above link for discussion. Summary: Streamline the writing and publishing of RFCs by relying on markdown and dedicated spellcheckers and linters. -- Regards, Robin Candau / Antiz
On 10/2/24 6:54 PM, Robin Candau wrote:
An RFC has now entered Final Comment Period. In 14 days, discussion will end and the proposal will either be accepted, rejected or withdrawn:
https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/43
Please visit the above link for discussion.
Summary: Streamline the writing and publishing of RFCs by relying on markdown and dedicated spellcheckers and linters.
Hey everyone, We've just identified that one particular intention of the RFC has not been written down specifically. Besides the specification to disable the line length linter, the actual intention was to build a policy around having exactly one sentence per line. The discussion came up during this thread: https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/45#note_222857 This would allow for easier diffs and reviews when specific parts are changed, as we avoid re-wrapping text. I wanted to raise this awareness and propose that we add a sentence to the specification explicitly explaining the intention to have a single sentence per line. Does anyone want to discuss this, or are we all on the same page about the intention? Cheers, Levente
Hi, On 14/11/2024 20:43, Levente Polyak wrote:
On 10/2/24 6:54 PM, Robin Candau wrote:
We've just identified that one particular intention of the RFC has not been written down specifically. Besides the specification to disable the line length linter, the actual intention was to build a policy around having exactly one sentence per line.
The discussion came up during this thread: https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/45#note_222857
This would allow for easier diffs and reviews when specific parts are changed, as we avoid re-wrapping text.
I wanted to raise this awareness and propose that we add a sentence to the specification explicitly explaining the intention to have a single sentence per line. Does anyone want to discuss this, or are we all on the same page about the intention?
I understand where this would be beneficial on diffs. +1 for adding the reasoning and explicitly stating the policy of one line per sentence. -- Leonidas Spyropoulos Developer & DevOps PGP: 244740D17C7FD0EC
On 11/14/24 9:43 PM, Levente Polyak wrote:
On 10/2/24 6:54 PM, Robin Candau wrote:
An RFC has now entered Final Comment Period. In 14 days, discussion will end and the proposal will either be accepted, rejected or withdrawn:
https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/43
Please visit the above link for discussion.
Summary: Streamline the writing and publishing of RFCs by relying on markdown and dedicated spellcheckers and linters.
Hey everyone,
We've just identified that one particular intention of the RFC has not been written down specifically. Besides the specification to disable the line length linter, the actual intention was to build a policy around having exactly one sentence per line.
The discussion came up during this thread: https://gitlab.archlinux.org/archlinux/rfcs/-/merge_requests/45#note_222857
This would allow for easier diffs and reviews when specific parts are changed, as we avoid re-wrapping text.
As one of the author of this RFC, I apologize that we did not made that point clear enough right from the start.
I wanted to raise this awareness and propose that we add a sentence to the specification explicitly explaining the intention to have a single sentence per line. Does anyone want to discuss this, or are we all on the same page about the intention?
+1 for me :)
Cheers, Levente
-- Regards, Robin Candau / Antiz
participants (3)
-
Leonidas Spyropoulos
-
Levente Polyak
-
Robin Candau