From patchwork Thu Mar 9 01:03:34 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sean Christopherson X-Patchwork-Id: 6327 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:5915:0:0:0:0:0 with SMTP id v21csp22480wrd; Wed, 8 Mar 2023 17:08:47 -0800 (PST) X-Google-Smtp-Source: AK7set8RgWCG6diPSUiW8QWeaBsj/d9buCBxo5vbJWruEhC4dmRW/8UKF3Yn2cBOWACzEXtP5xBU X-Received: by 2002:a1f:738f:0:b0:3e1:79a5:74d7 with SMTP id o137-20020a1f738f000000b003e179a574d7mr11501873vkc.10.1678324126851; Wed, 08 Mar 2023 17:08:46 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1678324126; cv=none; d=google.com; s=arc-20160816; b=aO9CQBXbac+V0aJNemwxVXG34hqEUZTghbuLkJU3PRV6DSLwKGIPmta2oLkpPzZMq/ tkZt934UnUK4QcCfoCosAlzH3RT14AAwPmdwt+U3/83ROf+W5doskkGfNFYdGosuDwQl YKbAZxbPj/eiOo2hoJcGiVjw8GTspfU3Qu6soNatx2JfHZOeX0johHseC2YR6JO3HeBm oEg7yWQGH9VsG9FTSxqXo9pZGCa/kpmSVrAB2ckvs3pIDbNAVhcSNt5nRbZtXM5D8mMY lv4BqC54xCT0g3PacJIulRu2yoxNP5NxG8Dmxe9kQjR2ynQWFLTNYZOIISguxhut/MCv C3cQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:from:subject:message-id:mime-version:date :reply-to:dkim-signature; bh=m4Kgj90WAIRpMSk15gHVq1rdI6z2bGt/9q+3/N1bx1M=; b=zzRsqXuCZsPqLxtvYeNSWE+bA/gSANXVpb9meEUr+3H1OFjBztY8NidTpM/nhZ8vgn fHXPRDv/CzvT/pTgnHti0PmoRxUAZPlt0du2qLi4CHIieYfSgmPZWR/6hytZtq31Dd5q 3AMeTOcOl2rPjZYvhyuxh2/kdBv6CcUIDy2GEdLjSedUAuc16bA6FW0Tk7q6LfES3y5A D+SK1lXICb5hyp6LCfwGz+DRFZDSi8LAyi9hiU71v5TRuVpo2NS0nU8AqBEMPNuY/hKj bqlvZxB0KfOdSa/MA8NakkvUEcPyscY/uXWHq8I6HS5gxeSCJ/NyR6KAMyDligs1jBPl KQMw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20210112 header.b="cUy/iFCR"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id a13-20020a056122012d00b0041346bd2bacsi5361809vko.293.2023.03.08.17.08.31; Wed, 08 Mar 2023 17:08:46 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20210112 header.b="cUy/iFCR"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229876AbjCIBDv (ORCPT + 99 others); Wed, 8 Mar 2023 20:03:51 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37360 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229844AbjCIBDs (ORCPT ); Wed, 8 Mar 2023 20:03:48 -0500 Received: from mail-pf1-x449.google.com (mail-pf1-x449.google.com [IPv6:2607:f8b0:4864:20::449]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 36B0E80910 for ; Wed, 8 Mar 2023 17:03:39 -0800 (PST) Received: by mail-pf1-x449.google.com with SMTP id a23-20020a62bd17000000b0058db55a8d7aso305347pff.21 for ; Wed, 08 Mar 2023 17:03:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; t=1678323819; h=cc:to:from:subject:message-id:mime-version:date:reply-to:from:to:cc :subject:date:message-id:reply-to; bh=m4Kgj90WAIRpMSk15gHVq1rdI6z2bGt/9q+3/N1bx1M=; b=cUy/iFCRkRNH+7tPQLWb+98G4wIahK2hGkuUeg6xfDpvcgUCGF8UTqGTpWuVvzgHcB WY8jDNLE1IDwFQ8EYUk/Wk+mmpum2gsubEnDtiv/35GkqBX0XA3cfEKXtNrNo5wlshdN XmCOyAbfl7BxnKqWbCx+4PlXYmAkjH+frEdXAOwVqk8qMgox5p4vQPh/tAAyylGA/qZ5 73TrIG8Xeuw2Gu2s/60UxvJcwWGawwUhhAhEdeb8Citqpzt5BdpD3iFKZvQEMhDYXWEh RY+3t+K8HVxuLkP90h90L2BIFD5e7xWjbUSl8D7+sJMS08jMJPBjn24Ojq94AR8nuJmz APBw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1678323819; h=cc:to:from:subject:message-id:mime-version:date:reply-to :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=m4Kgj90WAIRpMSk15gHVq1rdI6z2bGt/9q+3/N1bx1M=; b=HPnvZrbiNFHI4k3XjuNdIM83eNLnpUQtrOT2awz8+kw1VtOUSYnPN0Z9jGvwDyXerA UzBX+ebdKFCTsnvUfosIDFmDgZ9x9t+naOjfoqkfLZEgFZwOQ+vvebed23xrUTQdqFTI EgcMJ/AersNNXLxFVJj8Jtr6eSjf+9/zg1ixDkDzK5lWV/bJ7VEiRJKtK52ZpO+RBBd7 5rRbyPvvCSRUaWmYW3wxgRJMJIyiEdla6ElVbEZ8o4U1EhebaBUEtDcX6YjwgUD1Qi+J S7zC+WRDA7om1k70totmfjdwc8zT2J5QP2ROlUCgP0wbhgxVm2+cUvqa97cTbc5JPYIS I0gw== X-Gm-Message-State: AO0yUKUPZtISSQRi7jvlrYkJ50oxRm7R55PLvNksEP9vOLoY/8hWofN6 RrklZLk1hh8WeaFvShjRShl1bfZSZgs= X-Received: from zagreus.c.googlers.com ([fda3:e722:ac3:cc00:7f:e700:c0a8:5c37]) (user=seanjc job=sendgmr) by 2002:a62:ce87:0:b0:5da:cbe6:c0fb with SMTP id y129-20020a62ce87000000b005dacbe6c0fbmr8596647pfg.4.1678323819285; Wed, 08 Mar 2023 17:03:39 -0800 (PST) Reply-To: Sean Christopherson Date: Wed, 8 Mar 2023 17:03:34 -0800 Mime-Version: 1.0 X-Mailer: git-send-email 2.40.0.rc1.284.g88254d51c5-goog Message-ID: <20230309010336.519123-1-seanjc@google.com> Subject: [PATCH v2 0/2] Documentation/process: Add a maintainer handbook for KVM x86 From: Sean Christopherson To: Paolo Bonzini , Sean Christopherson Cc: Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , Sagi Shahar , Erdem Aktas , Peter Shier , Anish Ghulati , Oliver Upton , James Houghton , Anish Moorthy , Ben Gardon , David Matlack , Ricardo Koller , Axel Rasmussen , Aaron Lewis , Ashish Kalra , Babu Moger , Chao Gao , Chao Peng , Chenyi Qiang , David Woodhouse , Emanuele Giuseppe Esposito , Gavin Shan , Guang Zeng , Hou Wenlong , Jiaxi Chen , Jim Mattson , Jing Liu , Junaid Shahid , Kai Huang , Leonardo Bras , Like Xu , Li RongQing , "Maciej S . Szmigiero" , Maxim Levitsky , Michael Roth , Michal Luczaj , Mingwei Zhang , Nikunj A Dadhania , Paul Durrant , Peng Hao , Peter Gonda , Peter Xu , Robert Hoo , Suravee Suthikulpanit , Tom Lendacky , Vipin Sharma , Vitaly Kuznetsov , Wanpeng Li , Wei Wang , Xiaoyao Li , Yu Zhang , Zhenzhong Duan , kvm@vger.kernel.org, linux-kernel@vger.kernel.org X-Spam-Status: No, score=-9.6 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS,USER_IN_DEF_DKIM_WL autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1759850386680835101?= X-GMAIL-MSGID: =?utf-8?q?1759850399671814670?= Dcumentation for contributing to KVM x86, round 2! 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 | 391 ++++++++++++++++++ Documentation/process/maintainer-tip.rst | 2 + MAINTAINERS | 1 + 4 files changed, 395 insertions(+) create mode 100644 Documentation/process/maintainer-kvm-x86.rst base-commit: 3ac88fa4605ec98e545fb3ad0154f575fda2de5f