From nobody Tue Feb 10 01:50:47 2026 Delivered-To: importer@patchew.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1500529506436826.7035860464885; Wed, 19 Jul 2017 22:45:06 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 6440521D147D8; Wed, 19 Jul 2017 22:42:29 -0700 (PDT) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id AE06721CF25DF for ; Wed, 19 Jul 2017 22:42:23 -0700 (PDT) Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 19 Jul 2017 22:44:19 -0700 Received: from vwlee-mobl5.amr.corp.intel.com (HELO mdkinney-MOBL1.amr.corp.intel.com) ([10.254.81.214]) by orsmga004.jf.intel.com with ESMTP; 19 Jul 2017 22:44:18 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.40,382,1496127600"; d="scan'208";a="109947253" From: Michael D Kinney To: edk2-devel@lists.01.org Date: Wed, 19 Jul 2017 22:44:11 -0700 Message-Id: <20170720054411.18928-9-michael.d.kinney@intel.com> X-Mailer: git-send-email 2.13.1.windows.2 In-Reply-To: <20170720054411.18928-1-michael.d.kinney@intel.com> References: <20170720054411.18928-1-michael.d.kinney@intel.com> Subject: [edk2] [Patch V3 8/8] edk2: Add Readme.md to root of edk2 repository X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Jordan Justen , Andrew Fish , Leif Lindholm MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" https://bugzilla.tianocore.org/show_bug.cgi?id=3D643 Add Readme.md with a brief description of the EDK II open source project along with links to contribution agreement, licenses, and resources. It also provides the Change Description / Commit Message / Patch Email details that were moved out of the Contributions.txt file. Cc: Leif Lindholm Cc: Andrew Fish Cc: Jordan Justen Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney --- Readme.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++= ++++ 1 file changed, 72 insertions(+) create mode 100644 Readme.md diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000000..a50a7df5c1 --- /dev/null +++ b/Readme.md @@ -0,0 +1,72 @@ +# EDK II Project + +A modern, feature-rich, cross-platform firmware development environment +for the UEFI and PI specifications from www.uefi.org. + +Contributions to the EDK II open source project are covered by the=20 +[TianoCore Contribution Agreement 1.1](Contributions.txt) + +The majority of the content in the EDK II open source project uses a +[BSD 2-Clause License](LICENSE). The EDK II open source project contains +the following components that are covered by additional licenses: +* [AppPkg/Applications/Python/Python-2.7.2/Tools/pybench](AppPkg/Applicati= ons/Python/Python-2.7.2/Tools/pybench/LICENSE) +* [AppPkg/Applications/Python/Python-2.7.2](AppPkg/Applications/Python/Pyt= hon-2.7.2/LICENSE) +* [AppPkg/Applications/Python/Python-2.7.10](AppPkg/Applications/Python/Py= thon-2.7.10/LICENSE) +* [BaseTools/Source/C/BrotliCompress](BaseTools/Source/C/BrotliCompress/LI= CENSE) +* [MdeModulePkg/Library/BrotliCustomDecompressLib](MdeModulePkg/Library/Br= otliCustomDecompressLib/LICENSE) +* [OvmfPkg/Include/IndustryStandard/Xen](OvmfPkg/License.txt) +* [OvmfPkg/XenBusDxe](OvmfPkg/License.txt) +* [OvmfPkg/XenPvBlkDxe](OvmfPkg/License.txt) +* [CryptoPkg/Library/OpensslLib/openssl](CryptoPkg/Library/OpensslLib/open= ssl/LICENSE) + +# Resources +* [TianoCore](http://www.tianocore.org) +* [EDK II](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II) +* [Getting Started with EDK II](https://github.com/tianocore/tianocore.git= hub.io/wiki/Getting-Started-with-EDK-II) +* [Mailing Lists](https://github.com/tianocore/tianocore.github.io/wiki/Ma= iling-Lists) +* [TianoCore Bugzilla](https://bugzilla.tianocore.org) +* [How To Contribute](https://github.com/tianocore/tianocore.github.io/wik= i/How-To-Contribute) + +# Change Description / Commit Message / Patch Email + +Your change description should use the standard format for a +commit message, and must include your `Signed-off-by` signature +and the `Contributed-under` message. + +## Sample Change Description / Commit Message + +``` +From: Contributor Name +Subject: [PATCH] CodeModule: Brief-single-line-summary + +Full-commit-message + +Contributed-under: TianoCore Contribution Agreement 1.0 +Signed-off-by: Contributor Name +--- + +An extra message for the patch email which will not be considered part +of the commit message can be added here. + +Patch content inline or attached +``` +## Notes for sample patch email + +* The first line of commit message is taken from the email's subject + line following `[PATCH]`. The remaining portion of the commit message + is the email's content until the `---` line. +* git format-patch is one way to create this format + +## Definitions for sample patch email + +* **`CodeModule`** - a short idenfier for the affected code. For + example `MdePkg`, or `MdeModulePkg/UsbBusDxe`. +* **`Brief-single-line-summary`** - a short summary of the change. + The entire first line should be less than ~70 characters. +* **`Full-commit-message`** - a verbose multiple line comment describing + the change. Each line should be less than ~70 characters. +* **`Contributed-under`** - explicitely states that the contribution is + made under the terms of the contribtion agreement. This + agreement is included below in this document. +* **`Signed-off-by`** - the contributor's signature identifying them + by their real/legal name and their email address. --=20 2.13.1.windows.2 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel