From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9D62DC77B6F for ; Tue, 11 Apr 2023 17:17:06 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230044AbjDKRRF (ORCPT ); Tue, 11 Apr 2023 13:17:05 -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-Google-Smtp-Source: AKy350aOFuqLb4Xj6nP4d09SKpKOHeyL6TU4ugtbhHOugVmN4JDIGyDDtdUShlrt2xoUXZNRXoQWTEoTZwA= 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 Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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