From patchwork Fri Sep 11 12:40:01 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: George Dunlap X-Patchwork-Id: 11770439 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 86014618 for ; Fri, 11 Sep 2020 12:41:00 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 58EA2206DB for ; Fri, 11 Sep 2020 12:41:00 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=citrix.com header.i=@citrix.com header.b="XnUrU6GQ" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 58EA2206DB Authentication-Results: mail.kernel.org; dmarc=fail (p=reject dis=none) header.from=citrix.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1kGiM2-0006h4-IA; Fri, 11 Sep 2020 12:40:38 +0000 Received: from all-amaz-eas1.inumbo.com ([34.197.232.57] helo=us1-amaz-eas2.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1kGiM1-0006gu-HB for xen-devel@lists.xenproject.org; Fri, 11 Sep 2020 12:40:37 +0000 X-Inumbo-ID: 8b275429-b684-4f38-8357-bb179e1de913 Received: from esa4.hc3370-68.iphmx.com (unknown [216.71.155.144]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id 8b275429-b684-4f38-8357-bb179e1de913; Fri, 11 Sep 2020 12:40:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=citrix.com; s=securemail; t=1599828036; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=E9jVzjewcHv8oSNd7zb4kMsDRgnBST4bkl0Ixsq38QY=; b=XnUrU6GQNFXZHEa/wO5mXO1fjYTTt/sqfpL7ppWxKqCCpgLeJ8p9N9IH J8Ji8PEqouH7f9HNupavHeDnagOoOUGtFi3m4DI8eZtxI67EgXUmw8/pe lKHByrgeaxK7Z1OMZswfCygd4vZHxO7Vn+xI567gAZ3M0s2YnQ072YilJ E=; Authentication-Results: esa4.hc3370-68.iphmx.com; dkim=none (message not signed) header.i=none IronPort-SDR: XuF3ypyX0E83P8EWuaTghwZqrfdb4XK77jdf8HFhWy9ULdSHs45FBLnA8f4LTGjiwoqvIrr7mw feOtRm/9Wq9bc+y4YLgvohiWa7+pMXohOupTT+1MZN+vPWFNTw+UZpScuEaCFr7v3MX0dm121J yD8p/ayOvbHRjnkZoD7/IMT2wM21cmv5wRWQkLPP/hs+uFcEAI+kqEGKKS8ILYo8WBGZ4srmWC 2JyfoOkhAUnZKtb99p2eE2rY8uWj9OUHFD7SvFvzI8EDVwsmyUXdBkXc7q5kpIgQudYHGJOPI2 Lkc= X-SBRS: 2.7 X-MesageID: 27470677 X-Ironport-Server: esa4.hc3370-68.iphmx.com X-Remote-IP: 162.221.158.21 X-Policy: $RELAYED X-IronPort-AV: E=Sophos;i="5.76,415,1592884800"; d="scan'208";a="27470677" From: George Dunlap To: CC: George Dunlap , Ian Jackson , Wei Liu , Andrew Cooper , Jan Beulich , "Stefano Stabellini" , Julien Grall , Paul Durrant Subject: [PATCH 0/8] Finding a home for the Code of Conduct Date: Fri, 11 Sep 2020 13:40:01 +0100 Message-ID: <20200911124009.3760032-1-george.dunlap@citrix.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" The Code of Conduct has been approved [1]; now we need to find it a home. Since we've started using sphinx for the hypervisor documents, I propose doing the same for the project-wide governance documents, starting with the Code of Conduct. This series takes Lars' code of conduct tree, written as individual MD files, and puts them into the sphinx documentation system. After this series, if you run "make html" in the top-level directory, you'll get the generated sphinx documentation in the build/ directory. The finalized Code of Conduct documentation can be found at: https://xenbits.xen.org/git-http/people/gdunlap/governance.git This series can be found on the branch out/move-to-sphinx/v1 And a rendered version of the governance can be found here: https://xenbits.xenproject.org/people/gdunlap/governance/ If there are no objections to this setup, I propose the following URL as a long-term home: https://xenbits.xenproject.org/governance And also moving both the main governance doc [2] and the security policy [3] into that system, to make it easier to update. Thoughts? [1] https://marc.info/?i=CB503BA1-979C-42E5-86C6-AFAB10C738DF@citrix.com%3E [2] https://xenproject.org/developers/governance/ [3] https://xenproject.org/developers/security-policy/ CC: Ian Jackson CC: Wei Liu CC: Andrew Cooper CC: Jan Beulich CC: Stefano Stabellini CC: Julien Grall CC: Paul Durrant George Dunlap (8): Add basic sphinx structure Move docs into source directory, rename to rst Convert code-of-conduct to rst Convert communication-guide.md to rst Convert code-review-guide.md to rst Convert communication-practice.md to RST Convert resolving-disagreement.md to rst Clean up index page Makefile | 20 ++ .../code-of-conduct.rst | 39 ++- .../code-review-guide.rst | 154 ++++++---- .../communication-guide.rst | 27 +- .../communication-practice.rst | 289 +++++++++++------- source/conf.py | 54 ++++ source/index.rst | 36 +++ .../resolving-disagreement.rst | 109 ++++--- 8 files changed, 495 insertions(+), 233 deletions(-) create mode 100644 Makefile rename code-of-conduct.md => source/code-of-conduct.rst (83%) rename code-review-guide.md => source/code-review-guide.rst (79%) rename communication-guide.md => source/communication-guide.rst (82%) rename communication-practice.md => source/communication-practice.rst (75%) create mode 100644 source/conf.py create mode 100644 source/index.rst rename resolving-disagreement.md => source/resolving-disagreement.rst (72%)