[PATCH 4/4] doc: Migrate Process wiki page to sphinx

Tom Rini trini at konsulko.com
Sat Jul 9 14:41:03 CEST 2022


On Sat, Jul 09, 2022 at 08:55:48AM +0200, Heinrich Schuchardt wrote:
> On 6/27/22 19:17, Tom Rini wrote:
> > Move the current Process wiki page to doc/develop/process.rst.  The
> > changes here are for formatting or slight rewording so that it reads
> > well when linking to other sphinx documents.
> > 
> > Signed-off-by: Tom Rini <trini at konsulko.com>
> > ---
> >   doc/develop/index.rst   |   1 +
> >   doc/develop/process.rst | 182 ++++++++++++++++++++++++++++++++++++++++
> >   2 files changed, 183 insertions(+)
> >   create mode 100644 doc/develop/process.rst
> > 
> > diff --git a/doc/develop/index.rst b/doc/develop/index.rst
> > index c0f4f0ba413a..eab00a55382a 100644
> > --- a/doc/develop/index.rst
> > +++ b/doc/develop/index.rst
> > @@ -11,6 +11,7 @@ General
> > 
> >      codingstyle
> >      designprinciples
> > +   process
> > 
> >   Implementation
> >   --------------
> > diff --git a/doc/develop/process.rst b/doc/develop/process.rst
> > new file mode 100644
> > index 000000000000..dd279fb9eff1
> > --- /dev/null
> > +++ b/doc/develop/process.rst
> > @@ -0,0 +1,182 @@
> > +.. SPDX-License-Identifier: GPL-2.0+:
> > +
> > +U-Boot Development Process
> > +==========================
> > +
> > +Management Summary
> > +------------------
> > +
> > +* Development happens in Release Cycles of 3 months.
> 
> Do we need all this capitalization?

It's for emphasis I believe.

> > +#. Notes:
> > +
> > +  #. In some cases more than one custodian may be affected or feel responsible.
> > +     To avoid duplicated efforts, the custodian who starts processing the
> > +     patch should send a short ACK to the mailing list.
> > +  #. We should create some tool to automatically do this.
> > +  #. This is well documented in :doc:`designprinciples`.
> > +  #. The custodian decides himself how recent the code must be.  It is
> > +     acceptable to request patches against the last officially released
> > +     version of U-Boot or newer.  Of course a custodian can also accept
> > +     patches against older code.
> > +  #. Commits should show original author in the ``author`` field and include all
> > +      sign off/ack lines.
> > +
> > +5. The custodian decides to accept or to reject the patch.
> 
> Don't mix # bullets and numbers.

I believe I needed to for them to render in order.  I guess I'll just
only do the number in v2.

-- 
Tom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 659 bytes
Desc: not available
URL: <https://lists.denx.de/pipermail/u-boot/attachments/20220709/d8636e0e/attachment.sig>


More information about the U-Boot mailing list