Messages in this thread | | | From | Dan Williams <> | Date | Sun, 24 Nov 2019 19:20:38 -0800 | Subject | Re: [PATCH] Documentation: riscv: add patch acceptance guidelines |
| |
On Sun, Nov 24, 2019 at 6:49 PM Paul Walmsley <paul.walmsley@sifive.com> wrote: > > On Sat, 23 Nov 2019, Dan Williams wrote: > > > I'm open to updating the headers to make a section heading that > > matches what you're trying to convey, however that header definition > > should be globally agreed upon. I don't want the document that tries > > to clarify per-subsystem behaviours itself to have per-subsystem > > permutations. I think we, subsystem maintainers, at least need to be > > able to agree on the topics we disagree on. > > Unless you're planning to, say, follow up with some kind of automated > process working across all of the profile documents in such a way that it > would make technical sense for the different sections to be standardized, > I personally don't see any need at all for profile document > standardization. As far as I can tell, these documents are meant for > humans, rather than computers, to read. And in the absence of a strong > technical rationale to limit how maintainers express themselves here, I > don't think it's justified. >
It's just a template, you're free to make sub-headings of your own choosing, but please try to give a contributor that is spanning subsystems a chance to navigate similar information across profile documents.
| |