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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20230411171651.1067966-1-seanjc@google.com>
Date:   Tue, 11 Apr 2023 10:16:49 -0700
From:   Sean Christopherson <seanjc@...gle.com>
To:     Paolo Bonzini <pbonzini@...hat.com>,
        Sean Christopherson <seanjc@...gle.com>
Cc:     Thomas Gleixner <tglx@...utronix.de>,
        Ingo Molnar <mingo@...hat.com>, Borislav Petkov <bp@...en8.de>,
        Dave Hansen <dave.hansen@...ux.intel.com>,
        Sagi Shahar <sagis@...gle.com>,
        Erdem Aktas <erdemaktas@...gle.com>,
        Peter Shier <pshier@...gle.com>,
        Anish Ghulati <aghulati@...gle.com>,
        Oliver Upton <oliver.upton@...ux.dev>,
        James Houghton <jthoughton@...gle.com>,
        Anish Moorthy <amoorthy@...gle.com>,
        Ben Gardon <bgardon@...gle.com>,
        David Matlack <dmatlack@...gle.com>,
        Ricardo Koller <ricarkol@...gle.com>,
        Axel Rasmussen <axelrasmussen@...gle.com>,
        Aaron Lewis <aaronlewis@...gle.com>,
        Ashish Kalra <ashish.kalra@....com>,
        Babu Moger <babu.moger@....com>, Chao Gao <chao.gao@...el.com>,
        Chao Peng <chao.p.peng@...ux.intel.com>,
        Chenyi Qiang <chenyi.qiang@...el.com>,
        David Woodhouse <dwmw@...zon.co.uk>,
        Emanuele Giuseppe Esposito <eesposit@...hat.com>,
        Gavin Shan <gshan@...hat.com>,
        Guang Zeng <guang.zeng@...el.com>,
        Hou Wenlong <houwenlong.hwl@...group.com>,
        Jiaxi Chen <jiaxi.chen@...ux.intel.com>,
        Jim Mattson <jmattson@...gle.com>,
        Jing Liu <jing2.liu@...el.com>,
        Junaid Shahid <junaids@...gle.com>,
        Kai Huang <kai.huang@...el.com>,
        Leonardo Bras <leobras@...hat.com>,
        Like Xu <like.xu.linux@...il.com>,
        Li RongQing <lirongqing@...du.com>,
        "Maciej S . Szmigiero" <maciej.szmigiero@...cle.com>,
        Maxim Levitsky <mlevitsk@...hat.com>,
        Michael Roth <michael.roth@....com>,
        Michal Luczaj <mhal@...x.co>,
        Mingwei Zhang <mizhang@...gle.com>,
        Nikunj A Dadhania <nikunj@....com>,
        Paul Durrant <pdurrant@...zon.com>,
        Peng Hao <flyingpenghao@...il.com>,
        Peter Gonda <pgonda@...gle.com>, Peter Xu <peterx@...hat.com>,
        Robert Hoo <robert.hu@...ux.intel.com>,
        Suravee Suthikulpanit <suravee.suthikulpanit@....com>,
        Tom Lendacky <thomas.lendacky@....com>,
        Vipin Sharma <vipinsh@...gle.com>,
        Vitaly Kuznetsov <vkuznets@...hat.com>,
        Wanpeng Li <wanpengli@...cent.com>,
        Wei Wang <wei.w.wang@...el.com>,
        Xiaoyao Li <xiaoyao.li@...el.com>,
        Yu Zhang <yu.c.zhang@...ux.intel.com>,
        Zhenzhong Duan <zhenzhong.duan@...el.com>,
        Bagas Sanjaya <bagasdotme@...il.com>, kvm@...r.kernel.org,
        linux-kernel@...r.kernel.org
Subject: [PATCH v3 0/2] Documentation/process: Add a maintainer handbook for
 KVM x86

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@google.com

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