public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
From: "Leif Lindholm" <leif@nuviainc.com>
To: michael.kubacki@outlook.com
Cc: devel@edk2.groups.io, Andrew Fish <afish@apple.com>,
	Laszlo Ersek <lersek@redhat.com>,
	Michael D Kinney <michael.d.kinney@intel.com>
Subject: Re: [PATCH v3 7/7] ReadMe: Convert to rst and add Platform CI Status
Date: Mon, 27 Apr 2020 13:30:27 +0100	[thread overview]
Message-ID: <20200427123027.GR14075@vanye> (raw)
In-Reply-To: <MWHPR07MB3440D55428DA6991B86F0B63E9D00@MWHPR07MB3440.namprd07.prod.outlook.com>

On Fri, Apr 24, 2020 at 14:31:08 -0700, michael.kubacki@outlook.com wrote:
> From: Sean Brogan <sean.brogan@microsoft.com>
> 
> REF:https://bugzilla.tianocore.org/show_bug.cgi?id=2570
> 
> Convert workspace root Readme.md to reStructuredText
> ReStructuredText supports building tables with syntax that is easier
> to read in plain-text.
> Rename as ReadMe.rst.
> Add Platform CI Status Tables
> 
> Cc: Andrew Fish <afish@apple.com>
> Cc: Laszlo Ersek <lersek@redhat.com>
> Cc: Leif Lindholm <leif@nuviainc.com>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>
> Signed-off-by: Sean Brogan <sean.brogan@microsoft.com>

With the above line dropped:
Reviewed-by: Leif Lindholm <leif@nuviainc.com>

Thanks Sean, this is a big improvement!

> Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
> Reviewed-by: Laszlo Ersek <lersek@redhat.com>
> Reviewed-by: Bret Barkelew <bret.barkelew@microsoft.com>
> ---
>  ReadMe.rst | 354 ++++++++++++++++++++
>  Readme.md  | 235 -------------
>  2 files changed, 354 insertions(+), 235 deletions(-)
> 
> diff --git a/ReadMe.rst b/ReadMe.rst
> new file mode 100644
> index 000000000000..c4a29b2809ba
> --- /dev/null
> +++ b/ReadMe.rst
> @@ -0,0 +1,354 @@
> +==============
> +EDK II Project
> +==============
> +
> +A modern, feature-rich, cross-platform firmware development
> +environment for the UEFI and PI specifications from www.uefi.org.
> +
> +Core CI Build Status
> +--------------------
> +
> +============================= ================= =============== ===================
> + Host Type & Toolchain        Build Status      Test Status     Code Coverage
> +============================= ================= =============== ===================
> +Windows_VS2019_               |WindowsCiBuild|  |WindowsCiTest| |WindowsCiCoverage|
> +Ubuntu_GCC5_                  |UbuntuCiBuild|   |UbuntuCiTest|  |UbuntuCiCoverage|
> +============================= ================= =============== ===================
> +
> +`More CI Build information <.pytool/Readme.md>`__
> +
> +Platform CI Build Status
> +------------------------
> +
> +Microsoft Windows VS2019
> +````````````````````````
> +
> +============================= ================= ============= ============= ==============
> + Toolchain                    CONFIG            DEBUG         RELEASE       NOOPT
> +============================= ================= ============= ============= ==============
> +EmulatorPkg_Win_VS2019_       | IA32            |em32d|       |em32r|       |em32n|
> +|                             | X64             |em64d|       |em64r|       |em64n|
> +OvmfPkg_Win_VS2019_           | IA32            |op32d|       |op32r|       |op32n|
> +|                             | X64             |op64d|       |op64r|       |op64n|
> +|                             | IA32 X64        |op3264d|     |op3264r|     |op3264n|
> +|                             | IA32 X64 FULL   |op3264fd|    |op3264fr|    |op3264fn|
> +============================= ================= ============= ============= ==============
> +
> +Ubuntu 18.04 GCC5
> +`````````````````
> +
> +============================= ================= ============= ============= ==============
> + Toolchain                    CONFIG            DEBUG         RELEASE       NOOPT
> +============================= ================= ============= ============= ==============
> +ArmVirtPkg_Ubuntu_GCC5_       | AARCH64         |avAArch64du| |avAArch64ru| |avAArch64nu|
> +|                             | ARM             |avArmdu|     |avArmru|     |avArmnu|
> +EmulatorPkg_Ubuntu_GCC5_      | IA32            |em32du|      |em32ru|      |em32nu|
> +|                             | X64             |em64du|      |em64ru|      |em64nu|
> +OvmfPkg_Ubuntu_GCC5_          | IA32            |op32du|      |op32ru|      |op32nu|
> +|                             | X64             |op64du|      |op64ru|      |op64nu|
> +|                             | IA32 X64        |op3264du|    |op3264ru|    |op3264nu|
> +|                             | IA32 X64 FULL   |op3264fdu|   |op3264fru|   |op3264fru|
> +============================= ================= ============= ============= ==============
> +
> +|TCBZ_2668|_ - EmulatorPkg Ubuntu GCC5 Segfaults during execution.
> +
> +|TCBZ_2639|_ - EmulatorPkg Ubuntu GCC5 Segfaults during execution.
> +
> +`More ArmVirtPkg CI Build Information <ArmVirtPkg/PlatformCI/ReadMe.md>`__
> +
> +`More EmulatorPkg CI Build Information <EmulatorPkg/PlatformCI/ReadMe.md>`__
> +
> +`More OvmfPkg CI Build Information <OvmfPkg/PlatformCI/ReadMe.md>`__
> +
> +
> +License Details
> +---------------
> +
> +The majority of the content in the EDK II open source project uses a
> +`BSD-2-Clause Plus Patent License <License.txt>`__. The EDK II open
> +source project contains the following components that are covered by additional
> +licenses:
> +
> +-  `BaseTools/Source/C/BrotliCompress/brotli <https://github.com/google/brotli/blob/master/LICENSE>`__
> +-  `MdeModulePkg/Library/BrotliCustomDecompressLib/brotli <https://github.com/google/brotli/blob/master/LICENSE>`__
> +-  `BaseTools/Source/C/LzmaCompress <BaseTools/Source/C/LzmaCompress/LZMA-SDK-README.txt>`__
> +-  `MdeModulePkg/Library/LzmaCustomDecompressLib <MdeModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt>`__
> +-  `IntelFrameworkModulePkg/Library/LzmaCustomDecompressLib/Sdk <IntelFrameworkModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt>`__
> +-  `BaseTools/Source/C/VfrCompile/Pccts <BaseTools/Source/C/VfrCompile/Pccts/RIGHTS>`__
> +-  `MdeModulePkg/Universal/RegularExpressionDxe/oniguruma <https://github.com/kkos/oniguruma/blob/master/README.md>`__
> +-  `OvmfPkg <OvmfPkg/License.txt>`__
> +-  `CryptoPkg/Library/OpensslLib/openssl <https://github.com/openssl/openssl/blob/50eaac9f3337667259de725451f201e784599687/LICENSE>`__
> +-  `ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3 <https://github.com/ucb-bar/berkeley-softfloat-3/blob/b64af41c3276f97f0e181920400ee056b9c88037/COPYING.txt>`__
> +
> +The EDK II Project is composed of packages. The maintainers for each package
> +are listed in `Maintainers.txt <Maintainers.txt>`__.
> +
> +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.github.io/wiki/Getting-Started-with-EDK-II>`__
> +-  `Mailing
> +   Lists <https://github.com/tianocore/tianocore.github.io/wiki/Mailing-Lists>`__
> +-  `TianoCore Bugzilla <https://bugzilla.tianocore.org>`__
> +-  `How To
> +   Contribute <https://github.com/tianocore/tianocore.github.io/wiki/How-To-Contribute>`__
> +-  `Release
> +   Planning <https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Release-Planning>`__
> +
> +Code Contributions
> +------------------
> +
> +To make a contribution to a TianoCore project, follow these steps.
> +
> +#. Create a change description in the format specified below to
> +    use in the source control commit log.
> +#. Your commit message must include your ``Signed-off-by`` signature
> +#. Submit your code to the TianoCore project using the process
> +    that the project documents on its web page. If the process is
> +    not documented, then submit the code on development email list
> +    for the project.
> +#. It is preferred that contributions are submitted using the same
> +    copyright license as the base project. When that is not possible,
> +    then contributions using the following licenses can be accepted:
> +
> +-  BSD (2-clause): http://opensource.org/licenses/BSD-2-Clause
> +-  BSD (3-clause): http://opensource.org/licenses/BSD-3-Clause
> +-  MIT: http://opensource.org/licenses/MIT
> +-  Python-2.0: http://opensource.org/licenses/Python-2.0
> +-  Zlib: http://opensource.org/licenses/Zlib
> +
> +For documentation:
> +
> +-  FreeBSD Documentation License
> +    https://www.freebsd.org/copyright/freebsd-doc-license.html
> +
> +Contributions of code put into the public domain can also be accepted.
> +
> +Contributions using other licenses might be accepted, but further
> +review will be required.
> +
> +Developer Certificate of Origin
> +-------------------------------
> +
> +Your change description should use the standard format for a
> +commit message, and must include your ``Signed-off-by`` signature.
> +
> +In order to keep track of who did what, all patches contributed must
> +include a statement that to the best of the contributor's knowledge
> +they have the right to contribute it under the specified license.
> +
> +The test for this is as specified in the `Developer's Certificate of
> +Origin (DCO) 1.1 <https://developercertificate.org/>`__. The contributor
> +certifies compliance by adding a line saying
> +
> +Signed-off-by: Developer Name developer@example.org
> +
> +where ``Developer Name`` is the contributor's real name, and the email
> +address is one the developer is reachable through at the time of
> +contributing.
> +
> +::
> +
> +    Developer's Certificate of Origin 1.1
> +
> +    By making a contribution to this project, I certify that:
> +
> +    (a) The contribution was created in whole or in part by me and I
> +        have the right to submit it under the open source license
> +        indicated in the file; or
> +
> +    (b) The contribution is based upon previous work that, to the best
> +        of my knowledge, is covered under an appropriate open source
> +        license and I have the right under that license to submit that
> +        work with modifications, whether created in whole or in part
> +        by me, under the same open source license (unless I am
> +        permitted to submit under a different license), as indicated
> +        in the file; or
> +
> +    (c) The contribution was provided directly to me by some other
> +        person who certified (a), (b) or (c) and I have not modified
> +        it.
> +
> +    (d) I understand and agree that this project and the contribution
> +        are public and that a record of the contribution (including all
> +        personal information I submit with it, including my sign-off) is
> +        maintained indefinitely and may be redistributed consistent with
> +        this project or the open source license(s) involved.
> +
> +Sample Change Description / Commit Message
> +------------------------------------------
> +
> +::
> +
> +    From: Contributor Name <contributor@example.com>
> +    Subject: [Repository/Branch PATCH] Pkg-Module: Brief-single-line-summary
> +
> +    Full-commit-message
> +
> +    Signed-off-by: Contributor Name <contributor@example.com>
> +
> +Notes for sample patch email
> +````````````````````````````
> +
> +-  The first line of commit message is taken from the email's subject
> +   line following ``[Repository/Branch PATCH]``. The remaining portion
> +   of the commit message is the email's content.
> +-  ``git format-patch`` is one way to create this format
> +
> +Definitions for sample patch email
> +``````````````````````````````````
> +
> +-  ``Repository`` is the identifier of the repository the patch applies.
> +    This identifier should only be provided for repositories other than
> +    ``edk2``. For example ``edk2-BuildSpecification`` or ``staging``.
> +-  ``Branch`` is the identifier of the branch the patch applies. This
> +    identifier should only be provided for branches other than
> +   ``edk2/master``.
> +    For example ``edk2/UDK2015``,
> +   ``edk2-BuildSpecification/release/1.27``, or
> +    ``staging/edk2-test``.
> +-  ``Module`` is a short identifier for the affected code or
> +   documentation. For example ``MdePkg``, ``MdeModulePkg/UsbBusDxe``, ``Introduction``, or
> +    ``EDK II INF File Format``.
> +-  ``Brief-single-line-summary`` is 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.
> +-  ``Signed-off-by`` is the contributor's signature identifying them
> +    by their real/legal name and their email address.
> +
> +Submodules
> +----------
> +
> +Submodule in EDK II is allowed but submodule chain should be avoided
> +as possible as we can. Currently EDK II contains the following submodules
> +
> +-  CryptoPkg/Library/OpensslLib/openssl
> +-  ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
> +-  MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
> +-  MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
> +-  BaseTools/Source/C/BrotliCompress/brotli
> +
> +ArmSoftFloatLib is actually required by OpensslLib. It's inevitable
> +in openssl-1.1.1 (since stable201905) for floating point parameter
> +conversion, but should be dropped once there's no such need in future
> +release of openssl.
> +
> +To get a full, buildable EDK II repository, use following steps of git
> +command
> +
> +.. code-block:: bash
> +
> +  git clone https://github.com/tianocore/edk2.git
> +  cd edk2
> +  git submodule update --init
> +  cd ..
> +
> +If there's update for submodules, use following git commands to get
> +the latest submodules code.
> +
> +.. code-block:: bash
> +
> +  cd edk2
> +  git pull
> +  git submodule update
> +
> +Note: When cloning submodule repos, '--recursive' option is not
> +recommended. EDK II itself will not use any code/feature from
> +submodules in above submodules. So using '--recursive' adds a
> +dependency on being able to reach servers we do not actually want
> +any code from, as well as needlessly downloading code we will not
> +use.
> +
> +.. ===================================================================
> +.. This is a bunch of directives to make the README file more readable
> +.. ===================================================================
> +
> +.. CoreCI
> +
> +.. _Windows_VS2019: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=32&branchName=master
> +.. |WindowsCiBuild| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/Windows%20VS2019%20CI?branchName=master
> +.. |WindowsCiTest| image:: https://img.shields.io/azure-devops/tests/tianocore/edk2-ci/32.svg
> +.. |WindowsCiCoverage| image:: https://img.shields.io/badge/coverage-coming_soon-blue
> +
> +.. _Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=31&branchName=master
> +.. |UbuntuCiBuild| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/Ubuntu%20GCC5%20CI?branchName=master
> +.. |UbuntuCiTest| image:: https://img.shields.io/azure-devops/tests/tianocore/edk2-ci/31.svg
> +.. |UbuntuCiCoverage| image:: https://img.shields.io/badge/coverage-coming_soon-blue
> +
> +.. ArmVirtPkg
> +
> +.. _ArmVirtPkg_Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci-play/_build/latest?definitionId=41&branchName=master
> +.. |avAArch64du| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/ArmVirtPkg/ArmVirtQemu%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_AARCH64_DEBUG
> +.. |avAArch64ru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/ArmVirtPkg/ArmVirtQemu%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_AARCH64_RELEASE
> +.. |avAArch64nu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/ArmVirtPkg/ArmVirtQemu%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_AARCH64_NOOPT
> +
> +.. |avArmdu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/ArmVirtPkg/ArmVirtQemu%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_ARM_DEBUG
> +.. |avArmru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/ArmVirtPkg/ArmVirtQemu%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_ARM_RELEASE
> +.. |avArmnu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/ArmVirtPkg/ArmVirtQemu%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_ARM_NOOPT
> +
> +.. EmulatorPkg
> +
> +.. |TCBZ_2668| image:: https://img.shields.io/bugzilla/2668?baseUrl=https%3A%2F%2Fbugzilla.tianocore.org
> +.. _TCBZ_2668: https://bugzilla.tianocore.org/show_bug.cgi?id=2668
> +
> +.. |TCBZ_2639| image:: https://img.shields.io/bugzilla/2639?baseUrl=https%3A%2F%2Fbugzilla.tianocore.org
> +.. _TCBZ_2639: https://bugzilla.tianocore.org/show_bug.cgi?id=2639
> +
> +.. _EmulatorPkg_Win_VS2019:  https://dev.azure.com/tianocore/edk2-ci-play/_build/latest?definitionId=40&branchName=master
> +.. _EmulatorPkg_Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci-play/_build/latest?definitionId=39&branchName=master
> +
> +.. |em32d| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_DEBUG
> +.. |em32du| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_DEBUG
> +.. |em32r| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_RELEASE
> +.. |em32ru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_RELEASE
> +.. |em32n| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_NOOPT
> +.. |em32nu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_NOOPT
> +
> +.. |em64d| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_DEBUG
> +.. |em64du| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_DEBUG
> +.. |em64r| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_RELEASE
> +.. |em64ru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_RELEASE
> +.. |em64n| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_NOOPT
> +.. |em64nu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/EmulatorPkg/EmulatorPkg%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_NOOPT
> +
> +.. OvmfPkg
> +
> +.. |TCBZ_2661| image:: https://img.shields.io/bugzilla/2661?baseUrl=https%3A%2F%2Fbugzilla.tianocore.org
> +.. _TCBZ_2661: https://bugzilla.tianocore.org/show_bug.cgi?id=2661
> +
> +.. _OvmfPkg_Win_VS2019:  https://dev.azure.com/tianocore/edk2-ci-play/_build/latest?definitionId=38&branchName=master/
> +.. _OvmfPkg_Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci-play/_build/latest?definitionId=37&branchName=master
> +
> +.. |op32d| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_DEBUG
> +.. |op32du| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_DEBUG
> +.. |op32r| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_RELEASE
> +.. |op32ru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_RELEASE
> +.. |op32n| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_NOOPT
> +.. |op32nu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_NOOPT
> +
> +.. |op64d| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_DEBUG
> +.. |op64du| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_DEBUG
> +.. |op64r| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_RELEASE
> +.. |op64ru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_RELEASE
> +.. |op64n| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_NOOPT
> +.. |op64nu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_NOOPT
> +
> +
> +.. |op3264d| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_DEBUG
> +.. |op3264du| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_DEBUG
> +.. |op3264r| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_RELEASE
> +.. |op3264ru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_RELEASE
> +.. |op3264n| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_NOOPT
> +.. |op3264nu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_NOOPT
> +
> +.. |op3264fd| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_DEBUG
> +.. |op3264fdu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_DEBUG
> +.. |op3264fr| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Windows%20VS2019?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_RELEASE
> +.. |op3264fru| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_RELEASE
> +.. |op3264fn| replace:: |TCBZ_2661|_
> +.. |op3264fnu| image:: https://dev.azure.com/tianocore/edk2-ci-play/_apis/build/status/OVMF/OVMF%20Ubuntu%20GCC5?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_NOOPT
> diff --git a/Readme.md b/Readme.md
> deleted file mode 100644
> index 843046365425..000000000000
> --- a/Readme.md
> +++ /dev/null
> @@ -1,235 +0,0 @@
> -# EDK II Project
> -
> -A modern, feature-rich, cross-platform firmware development environment
> -for the UEFI and PI specifications from www.uefi.org.
> -
> -# Build Status
> -
> -<table>
> -  <tr>
> -    <th>Host Type</th>
> -    <th>Toolchain</th>
> -    <th>Branch</th>
> -    <th>Build Status</th>
> -    <th>Test Status</th>
> -    <th>Code Coverage</th>
> -  </tr>
> -  <tr>
> -    <td>Windows</td>
> -    <td>VS2019</td>
> -    <td>master</td>
> -    <td>
> -      <a  href="https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=32&branchName=master">
> -      <img src="https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/Windows%20VS2019%20CI?branchName=master"/></a>
> -    </td>
> -    <td>
> -      <a  href="https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=32&branchName=master">
> -      <img src="https://img.shields.io/azure-devops/tests/tianocore/edk2-ci/32.svg"/></a>
> -    </td>
> -    <td>
> -      <a  href="https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=32&branchName=master">
> -      <img src="https://img.shields.io/badge/coverage-coming_soon-blue"/></a>
> -    </td>
> -  </tr>
> -  <tr>
> -    <td>Ubuntu</td>
> -    <td>GCC</td>
> -    <td>master</td>
> -    <td>
> -      <a  href="https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=31&branchName=master">
> -      <img src="https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/Ubuntu%20GCC5%20CI?branchName=master"/></a>
> -    </td>
> -    <td>
> -      <a  href="https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=31&branchName=master">
> -      <img src="https://img.shields.io/azure-devops/tests/tianocore/edk2-ci/31.svg"/></a>
> -    </td>
> -    <td>
> -      <a  href="https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=31&branchName=master">
> -      <img src="https://img.shields.io/badge/coverage-coming_soon-blue"/></a>
> -    </td>
> -  </tr>
> -</table>
> -
> -[More CI Build information](.pytool/Readme.md)
> -
> -# License Details
> -
> -The majority of the content in the EDK II open source project uses a
> -[BSD-2-Clause Plus Patent License](License.txt).  The EDK II open source project
> -contains the following components that are covered by additional licenses:
> -* [BaseTools/Source/C/BrotliCompress/brotli](https://github.com/google/brotli/blob/master/LICENSE)
> -* [MdeModulePkg/Library/BrotliCustomDecompressLib/brotli](https://github.com/google/brotli/blob/master/LICENSE)
> -* [BaseTools/Source/C/LzmaCompress](BaseTools/Source/C/LzmaCompress/LZMA-SDK-README.txt)
> -* [MdeModulePkg/Library/LzmaCustomDecompressLib](MdeModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt)
> -* [IntelFrameworkModulePkg/Library/LzmaCustomDecompressLib/Sdk](IntelFrameworkModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt)
> -* [BaseTools/Source/C/VfrCompile/Pccts](BaseTools/Source/C/VfrCompile/Pccts/RIGHTS)
> -* [MdeModulePkg/Universal/RegularExpressionDxe/oniguruma](https://github.com/kkos/oniguruma/blob/master/README.md)
> -* [OvmfPkg](OvmfPkg/License.txt)
> -* [CryptoPkg/Library/OpensslLib/openssl](https://github.com/openssl/openssl/blob/50eaac9f3337667259de725451f201e784599687/LICENSE)
> -* [ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3](https://github.com/ucb-bar/berkeley-softfloat-3/blob/b64af41c3276f97f0e181920400ee056b9c88037/COPYING.txt)
> -
> -The EDK II Project is composed of packages.  The maintainers for each package
> -are listed in [Maintainers.txt](Maintainers.txt).
> -
> -# 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.github.io/wiki/Getting-Started-with-EDK-II)
> -* [Mailing Lists](https://github.com/tianocore/tianocore.github.io/wiki/Mailing-Lists)
> -* [TianoCore Bugzilla](https://bugzilla.tianocore.org)
> -* [How To Contribute](https://github.com/tianocore/tianocore.github.io/wiki/How-To-Contribute)
> -* [Release Planning](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Release-Planning)
> -
> -# Code Contributions
> -To make a contribution to a TianoCore project, follow these steps.
> -1. Create a change description in the format specified below to
> -   use in the source control commit log.
> -2. Your commit message must include your `Signed-off-by` signature
> -3. Submit your code to the TianoCore project using the process
> -   that the project documents on its web page.  If the process is
> -   not documented, then submit the code on development email list
> -   for the project.
> -4. It is preferred that contributions are submitted using the same
> -   copyright license as the base project. When that is not possible,
> -   then contributions using the following licenses can be accepted:
> -   * BSD (2-clause): http://opensource.org/licenses/BSD-2-Clause
> -   * BSD (3-clause): http://opensource.org/licenses/BSD-3-Clause
> -   * MIT: http://opensource.org/licenses/MIT
> -   * Python-2.0: http://opensource.org/licenses/Python-2.0
> -   * Zlib: http://opensource.org/licenses/Zlib
> -
> -   For documentation:
> -   * FreeBSD Documentation License
> -     https://www.freebsd.org/copyright/freebsd-doc-license.html
> -
> -   Contributions of code put into the public domain can also be
> -   accepted.
> -
> -   Contributions using other licenses might be accepted, but further
> -   review will be required.
> -
> -# Developer Certificate of Origin
> -
> -Your change description should use the standard format for a
> -commit message, and must include your `Signed-off-by` signature.
> -
> -In order to keep track of who did what, all patches contributed must
> -include a statement that to the best of the contributor's knowledge
> -they have the right to contribute it under the specified license.
> -
> -The test for this is as specified in the [Developer's Certificate of
> -Origin (DCO) 1.1](https://developercertificate.org/). The contributor
> -certifies compliance by adding a line saying
> -
> -  Signed-off-by: Developer Name <developer@example.org>
> -
> -where `Developer Name` is the contributor's real name, and the email
> -address is one the developer is reachable through at the time of
> -contributing.
> -
> -```
> -Developer's Certificate of Origin 1.1
> -
> -By making a contribution to this project, I certify that:
> -
> -(a) The contribution was created in whole or in part by me and I
> -    have the right to submit it under the open source license
> -    indicated in the file; or
> -
> -(b) The contribution is based upon previous work that, to the best
> -    of my knowledge, is covered under an appropriate open source
> -    license and I have the right under that license to submit that
> -    work with modifications, whether created in whole or in part
> -    by me, under the same open source license (unless I am
> -    permitted to submit under a different license), as indicated
> -    in the file; or
> -
> -(c) The contribution was provided directly to me by some other
> -    person who certified (a), (b) or (c) and I have not modified
> -    it.
> -
> -(d) I understand and agree that this project and the contribution
> -    are public and that a record of the contribution (including all
> -    personal information I submit with it, including my sign-off) is
> -    maintained indefinitely and may be redistributed consistent with
> -    this project or the open source license(s) involved.
> -```
> -
> -# Sample Change Description / Commit Message
> -
> -```
> -From: Contributor Name <contributor@example.com>
> -Subject: [Repository/Branch PATCH] Pkg-Module: Brief-single-line-summary
> -
> -Full-commit-message
> -
> -Signed-off-by: Contributor Name <contributor@example.com>
> -```
> -
> -## Notes for sample patch email
> -
> -* The first line of commit message is taken from the email's subject
> -  line following `[Repository/Branch PATCH]`. The remaining portion of the
> -  commit message is the email's content.
> -* `git format-patch` is one way to create this format
> -
> -## Definitions for sample patch email
> -
> -* `Repository` is the identifier of the repository the patch applies.
> -  This identifier should only be provided for repositories other than
> -  `edk2`. For example `edk2-BuildSpecification` or `staging`.
> -* `Branch` is the identifier of the branch the patch applies. This
> -  identifier should only be provided for branches other than `edk2/master`.
> -  For example `edk2/UDK2015`, `edk2-BuildSpecification/release/1.27`, or
> -  `staging/edk2-test`.
> -* `Module` is a short identifier for the affected code or documentation. For
> -  example `MdePkg`, `MdeModulePkg/UsbBusDxe`, `Introduction`, or
> -  `EDK II INF File Format`.
> -* `Brief-single-line-summary` is 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.
> -* `Signed-off-by` is the contributor's signature identifying them
> -  by their real/legal name and their email address.
> -
> -# Submodules
> -
> -Submodule in EDK II is allowed but submodule chain should be avoided
> -as possible as we can. Currently EDK II contains the following submodules
> -
> -- CryptoPkg/Library/OpensslLib/openssl
> -- ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
> -- MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
> -- MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
> -- BaseTools/Source/C/BrotliCompress/brotli
> -
> -ArmSoftFloatLib is actually required by OpensslLib. It's inevitable
> -in openssl-1.1.1 (since stable201905) for floating point parameter
> -conversion, but should be dropped once there's no such need in future
> -release of openssl.
> -
> -To get a full, buildable EDK II repository, use following steps of git
> -command
> -
> -```
> -$ git clone https://github.com/tianocore/edk2.git
> -$ cd edk2
> -$ git submodule update --init
> -$ cd ..
> -```
> -
> -If there's update for submodules, use following git commands to get the
> -latest submodules code.
> -
> -```
> -$ cd edk2
> -$ git pull
> -$ git submodule update
> -```
> -
> -Note: When cloning submodule repos, '--recursive' option is not
> -recommended. EDK II itself will not use any code/feature from
> -submodules in above submodules. So using '--recursive' adds a
> -dependency on being able to reach servers we do not actually want
> -any code from, as well as needlessly downloading code we will not
> -use.
> -- 
> 2.16.3.windows.1
> 

      reply	other threads:[~2020-04-27 12:30 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <20200424213108.19888-1-michael.kubacki@outlook.com>
2020-04-24 21:31 ` [PATCH v3 1/7] .azurepipelines: Add Platform CI template Michael Kubacki
2020-04-24 21:31 ` [PATCH v3 2/7] ArmVirtPkg: Add Platform CI and configuration for Core CI Michael Kubacki
2020-04-27 12:22   ` Leif Lindholm
2020-04-27 21:21     ` Michael Kubacki
2020-04-28 10:23       ` Leif Lindholm
2020-04-28 12:47         ` Laszlo Ersek
2020-04-24 21:31 ` [PATCH v3 3/7] EmulatorPkg: " Michael Kubacki
2020-04-28 11:22   ` [edk2-devel] " Liming Gao
2020-04-24 21:31 ` [PATCH v3 4/7] OvmfPkg: " Michael Kubacki
2020-04-24 21:31 ` [PATCH v3 5/7] .pytool: Update CI Settings to support Emulator, ArmVirt, and Ovmf packages Michael Kubacki
2020-04-24 21:31 ` [PATCH v3 6/7] .azurepipelines: Update Core CI build matrix to include platforms Michael Kubacki
2020-04-24 21:31 ` [PATCH v3 7/7] ReadMe: Convert to rst and add Platform CI Status Michael Kubacki
2020-04-27 12:30   ` Leif Lindholm [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-list from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200427123027.GR14075@vanye \
    --to=devel@edk2.groups.io \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox