On Tue, Mar 23, 2021 at 09:44:53AM +0100, Daniel Vetter wrote: > Motivated by the pre-review process for i915 gem/gt features, but > probably useful in general for complex stuff. > > Cc: Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> > Cc: Joonas Lahtinen <joonas.lahtinen@xxxxxxxxxxxxxxx> > Cc: Rodrigo Vivi <rodrigo.vivi@xxxxxxxxx> > Cc: Jason Ekstrand <jason@xxxxxxxxxxxxxx> > Cc: Dave Airlie <airlied@xxxxxxxxxx> > Signed-off-by: Daniel Vetter <daniel.vetter@xxxxxxxxx> > --- > Documentation/gpu/index.rst | 1 + > Documentation/gpu/rfc.rst | 16 ++++++++++++++++ > 2 files changed, 17 insertions(+) > create mode 100644 Documentation/gpu/rfc.rst > > diff --git a/Documentation/gpu/index.rst b/Documentation/gpu/index.rst > index c9a51e3bfb5a..df58cb826d68 100644 > --- a/Documentation/gpu/index.rst > +++ b/Documentation/gpu/index.rst > @@ -16,6 +16,7 @@ Linux GPU Driver Developer's Guide > vga-switcheroo > vgaarbiter > todo > + rfc I understand the motivation here so I didn't commented earlier, but looking now, I'm wondering that this section will polute the official doc... > > .. only:: subproject and html > > diff --git a/Documentation/gpu/rfc.rst b/Documentation/gpu/rfc.rst > new file mode 100644 > index 000000000000..9d0ff2921af8 > --- /dev/null > +++ b/Documentation/gpu/rfc.rst > @@ -0,0 +1,16 @@ > +=============== > +GPU RFC Section > +=============== > + > +For complex work, especially new uapi, it is often good to nail the high level > +design issues before getting lost in the code details. This section is meant to > +host such documentation: > + > +* Each RFC should be a section in this file, explaining the goal and main design > + considerations. > + > +* For uapi structures add a file to this directory with and then pull the > + kerneldoc in like with real uapi headers. > + > +* Once the code has landed move all the documentation to the right places in > + the main core, helper or driver sections. > -- > 2.31.0 > _______________________________________________ Intel-gfx mailing list Intel-gfx@xxxxxxxxxxxxxxxxxxxxx https://lists.freedesktop.org/mailman/listinfo/intel-gfx
