From patchwork Tue Apr 11 17:16:49 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sean Christopherson X-Patchwork-Id: 8030 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp2736727vqo; Tue, 11 Apr 2023 10:22:49 -0700 (PDT) X-Google-Smtp-Source: AKy350atXvKH76w1h6jFTmoySkMOF6ZFCEDxVi6DF6V7WDEX4QX+FiNjlaBrk3bMocbgxcm0qG4d X-Received: by 2002:a17:902:fb03:b0:1a1:595a:8e3b with SMTP id le3-20020a170902fb0300b001a1595a8e3bmr15035214plb.34.1681233768844; Tue, 11 Apr 2023 10:22:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1681233768; cv=none; d=google.com; s=arc-20160816; b=ZhCNNc6b8pkmqFJF3SNakyrLXqzKdZGnhM4Qz0FtjXkY/u/ef+5kh0ydEtIabOLRAm xt0AfPucAclwWYC85si0pSVX7Ehv+tgPXiWrAHvxmg381zDQQuXPIUbD7ECkzt8P0H12 h98oV1GHJhHpkjX8twP5hHVsQBwCfP/dcyIGcDihs4ckLGrAwgHGmvsTomp+5DUqVrJz rH2VUITabA6ZjkOYLLijvTTySytrTfhh2vxLqLEHhVbiYr1Bw31QgGCIQW9p545Gri/0 Xr8XYslcYsjjYooEO/cUP/5Qq00C3YD5VnQzA2I8P8wkemrAXJDczq97BVnF75nuT4/Y isJQ== 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=rxRq7IEOowHT+3lZvfsRXImSkulOEzG82uwdGkSU48I=; b=P2qDbe10TcggYbNN0NsfIqd/9G7I2zLy+n9RQnLBKS9mUqj/eAEqK4vwGgjj55kw9N iy7lMhTcSPHww5/7t/r+X883vU52+L3NXiESmhBkXUcBVrojW5c4qrr2NBsaPfyhZLYz p1XhlyBVj2XX2Y0xVVXTy+3vcuGua72UGlOfIQtk5QJIJbZSR1JHkECr5WuySTNm14Vk Gqb7TMOwpyvXl2fh2heq9KtYCqiEbSu3dWcWNcHnkP2sBEvq8LQm3ChoBn0Zb0Hoc5Pa JwtuCknZ9DU6b8QdSjPWQUts/aNhpmuDIbtVOHIBqwxkmTd6HsgVZ1HCK30uzosJ9xer a4DA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=IEIUnJfK; 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 k69-20020a638448000000b005031abe8d8bsi5606843pgd.745.2023.04.11.10.22.35; Tue, 11 Apr 2023 10:22:48 -0700 (PDT) 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=20221208 header.b=IEIUnJfK; 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 S229617AbjDKRRE (ORCPT + 99 others); Tue, 11 Apr 2023 13:17:04 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40992 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229437AbjDKRRA (ORCPT ); Tue, 11 Apr 2023 13:17:00 -0400 Received: from mail-yw1-x1149.google.com (mail-yw1-x1149.google.com [IPv6:2607:f8b0:4864:20::1149]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4D5A749F6 for ; Tue, 11 Apr 2023 10:16:56 -0700 (PDT) Received: by mail-yw1-x1149.google.com with SMTP id 00721157ae682-54c0c9de33aso155128907b3.15 for ; Tue, 11 Apr 2023 10:16:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20221208; t=1681233415; h=cc:to:from:subject:message-id:mime-version:date:reply-to:from:to:cc :subject:date:message-id:reply-to; bh=rxRq7IEOowHT+3lZvfsRXImSkulOEzG82uwdGkSU48I=; b=IEIUnJfKT1h1+cZkb1XP2ptSpAyBOIu5i+dE3DGuWDt4Wv8yGnnU6YsR4hw1P1Rww2 5ARveRIB2sgXqKBkILJTbhnpymk/kafUHOkEROBI+uXPey9mGCmlPwSEQZZzzdflUKXL qWLOa0nUgBP0+VhNkEFnyRph0Q/k/o1Jo5tBdLpE9SpAqwSXRep/VgfkVPFZDM+e2NYh KNS5IKch27NzqpwghvRINaeYID+O5LeOSWkhheVEnxGM4Kzh+ETf7VNKR98bm9QhH+TT FYcTVYOeMEg/MkmV6tuhOsoWa2WwpXHEBpYTF8Wl0pMzo3Tzvea7i3GdD15BUEIgHVaF VMhw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1681233415; 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=rxRq7IEOowHT+3lZvfsRXImSkulOEzG82uwdGkSU48I=; b=P/JWMujh/USkJhMxW+wABcO7EGFa2JW2iePjOqsV+7LOs4UeOQ6+roUtDEfdzEKXr/ 9lx9PzKhf+lcxhyu+63KQjlXsebsvec2jgWwno1nkiKiDzSi9ESEGXaZawjqlryn2CNI 4CY2WJS9PNgjxQtzKfhZDdDTdIPVFEI7uIcYATfMyWJyXbqdGYjsbUTEwr5KXFLGoIhn d113V5ZK0O/VFJ1OqlO8oVKw3unJQ+wV3RlV/WU1jc1rJuwQTGmJsafpZNNQng7PfbzN gLmRh2BS7iHzmHg69+h2nlyMFUzVTNNtFTm1bHBkC3utLa8/Exu+vCs9pOOM4Gp3q1h2 oRVw== X-Gm-Message-State: AAQBX9eabKNG5VnvNzp1Y3jasT0zkPpUYQQN14+Pd5+8yc0uto2hOuqV hq6owjUgm3Jo3wj0Kl46/26Q0yt7XCk= X-Received: from zagreus.c.googlers.com ([fda3:e722:ac3:cc00:7f:e700:c0a8:5c37]) (user=seanjc job=sendgmr) by 2002:a25:d4d1:0:b0:b80:2bf9:2f78 with SMTP id m200-20020a25d4d1000000b00b802bf92f78mr10090547ybf.11.1681233415496; Tue, 11 Apr 2023 10:16:55 -0700 (PDT) Reply-To: Sean Christopherson Date: Tue, 11 Apr 2023 10:16:49 -0700 Mime-Version: 1.0 X-Mailer: git-send-email 2.40.0.577.gac1e443424-goog Message-ID: <20230411171651.1067966-1-seanjc@google.com> Subject: [PATCH v3 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 , Bagas Sanjaya , kvm@vger.kernel.org, linux-kernel@vger.kernel.org X-Spam-Status: No, score=-7.7 required=5.0 tests=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=unavailable 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?1762901380122519105?= X-GMAIL-MSGID: =?utf-8?q?1762901380122519105?= 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