u-boot.git/doc/develop, branch v2022.10-rc1

Prepare v2022.10-rc1

2022-07-26T00:31:12+00:00

Signed-off-by: Tom Rini

doc: typo 'formatted' in codingstyle.rst

2022-07-18T15:21:49+00:00

%s/formatted/format/

Fixes: 4211fb2ef6dd ("doc: Migrate CodingStyle wiki page to Sphinx")
Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Tom Rini

doc: Add in the historical release statistics found on the wiki

2022-07-14T18:14:47+00:00

The wiki had gitdm-generated release statistics starting with v1.3.0.
Re-generate this information as Sphinx.  This aims to be as historically
accurate as possible and so some company renames were kept to their old
rather than current name until we had made the switch previously.

Signed-off-by: Tom Rini

doc: process: Correct and expand slightly on the Merge Window concept

2022-07-14T18:14:29+00:00

For quite a long time we've been using a 3 week, rather than 2 week,
merge window as it was only 2 weeks during the timeframe where we did 2
month rather than 3 month releases.  This corrects the places that still
had 2 weeks and tries to make things a bit clearer overall.

Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

doc: Add doc/develop/release_cycle.rst

2022-07-14T18:14:27+00:00

Migrate the RelaseCycle wiki page to Sphinx.  In terms of visible
changes, we stop having a dynamic countdown to when the release is.  And
we drop the year-based statistics, that were not being kept up to date.
For the moment, we only link to statistics for v2022.07 but will add
back the historical data in a subsequent patch.

Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

process.rst: Modernize the "Workflow of a Custodian" section

2022-07-14T18:14:25+00:00

The "Workflow of a Custodian" section on the wiki had not been changed
in quite some time to reflect how the process has been functioning for
some time.  First, update some links to point to modern and current
sources of information.

Second, and more overarching, reword much of the section.  This expands
on the expectations of both custodians and developers when it comes to
rebasing patches.  Rework the final points to be clearer that Custodians
are expected to do their best to test the changes and ask for help when
needed, as well as that pull requests are expected in a timely manner.

Cc: Claudius Heine 
Cc: Martin Bonner 
Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

process.rst: Perform minor cleanups

2022-07-14T18:13:52+00:00

- Use gender-neutral language to refer to the user, consistently.
- Reword a few places so that they read more naturally.
- Make the long standing practice around "Twilight Time" more clear,
  hopefully.
- Replace a reference to MAKEALL with a reference to CI testing as
  that's the current requirement.

Cc: Claudius Heine 
Cc: Martin Bonner 
Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

designprinciples.rst: Perform minor cleanups

2022-07-14T18:13:50+00:00

- Remove some missed wiki markup, and escape a "\n" correctly.
- Use gender-neutral language to refer to the user, consistently.

Cc: Claudius Heine 
Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

doc: Migrate Process wiki page to Sphinx

2022-07-14T18:13:48+00:00

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.

Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

doc: codingstyle: Remove comment about '//' style comments

2022-07-14T18:13:46+00:00

For some time now we've allowed for '//' style comments, which mirrors
the Linux kernel.  So drop this point here.

Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini