[PATCH v3 0/2] Documentation/process: Add a maintainer handbook for KVM x86

From: Sean Christopherson
Date: Tue Apr 11 2023 - 13:17:06 EST


Dcumentation for contributing to KVM x86, round 3!

v3:
- Add language to clarify that "reverse fir tree" is also known as
"reverse Christmas tree or reverse XMAS tree". [Robert, Mingwei]
- Change guidance for patches/series that touch code outside of x86/kvm
to recommend/prescribe using a common base, e.g. release candidate,
not kvm-x86/next. [Bagas, Oliver]

v2:
- Fix a KVM_GET_SUPPORTED_CPUID typo. [Yuan]
- Give Cthulhu the respect it deserves. [Like]
- Explicitly state that selftests vs. KVM patches need to maintain
bisection (when possible). [Like]
- Change the recommended base from topic branches to "next" (and plan on
providing stable, persistent git objects via tags). [David W]
- Add a blurb to provide guidance for series that touch non-x86 arch
code. [Yu]
- Clarify when (not) to reference/quote specs (APM and SDM). [Maciej]
- Add preferences for shortlog length. [Maciej]
- Exempt things like comment fixes from testing requirements. [Maciej]
- Add a foreword to try and make the doc less scary to newcomers. [Maciej]
- Add a rule for testing Documentation/ changes.
- Clarify that fixes for the current cycle may be carried in the KVM x86
tree, but are usually taken directly by Paolo. [Robert]
- Tweak the "Changelog" section to call out that using imperative mood
and avoiding pronouns is the most important rule.

v1: https://lore.kernel.org/all/20230217225449.811957-1-seanjc@xxxxxxxxxx

Sean Christopherson (2):
Documentation/process: Add a label for the tip tree handbook's coding
style
Documentation/process: Add a maintainer handbook for KVM x86

.../process/maintainer-handbooks.rst | 1 +
Documentation/process/maintainer-kvm-x86.rst | 390 ++++++++++++++++++
Documentation/process/maintainer-tip.rst | 2 +
MAINTAINERS | 1 +
4 files changed, 394 insertions(+)
create mode 100644 Documentation/process/maintainer-kvm-x86.rst


base-commit: 09a9639e56c01c7a00d6c0ca63f4c7c41abe075d
--
2.40.0.577.gac1e443424-goog