From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) by mx.groups.io with SMTP id smtpd.web10.19849.1670257513188350240 for ; Mon, 05 Dec 2022 08:25:13 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@quicinc.com header.s=qcppdkim1 header.b=dcS71glM; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: quicinc.com, ip: 205.220.168.131, mailfrom: quic_rcran@quicinc.com) Received: from pps.filterd (m0279863.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2B5Ankf9020971; Mon, 5 Dec 2022 16:25:06 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=quicinc.com; h=message-id : date : mime-version : subject : to : cc : references : from : in-reply-to : content-type : content-transfer-encoding; s=qcppdkim1; bh=fePuMvrv1cX5NBP7jSd7GoOxB8Ozq8cDk3AxCYPdq9k=; b=dcS71glMidWJBr1EYd/K+azoce8jghi7ubu+BRGXT8eFShWrwvtlkEI+Tdpektg6StTk m4U3NHRmWb/I6c4sUbdsIiuM5XItXDqoEW5Wc0yZF6YaTuXv1E9+8PeX0nlnOzbxdig4 891EvzFqJOYrdOu2vUK1TBcwKG8op1RPqWIYr3Duzm8aIa6Gj+CUvg2v4wHdWayZhWUx /1bNnk3U8+FAyCfVXPyHY3qgAtwgjDdtoXgqLvHggsXyAiFc9jz4Ec0s/XLyCU/uxGlx khktmoXAXpE20bVKDxRy5m8fQpfRQoWRQ3QyRq8RgKob2ZuOvXSlPlJ4j4psYi/MMHdJ PA== Received: from nasanppmta04.qualcomm.com (i-global254.qualcomm.com [199.106.103.254]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 3m7xp8mjt0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 05 Dec 2022 16:25:06 +0000 Received: from nasanex01b.na.qualcomm.com (nasanex01b.na.qualcomm.com [10.46.141.250]) by NASANPPMTA04.qualcomm.com (8.17.1.5/8.17.1.5) with ESMTPS id 2B5GP56E015390 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 5 Dec 2022 16:25:05 GMT Received: from [10.110.8.230] (10.80.80.8) by nasanex01b.na.qualcomm.com (10.46.141.250) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Mon, 5 Dec 2022 08:25:04 -0800 Message-ID: <3f28d893-1dfd-f6c6-9067-a164d5b679bd@quicinc.com> Date: Mon, 5 Dec 2022 09:25:04 -0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.5.1 Subject: Re: [edk2-devel] [edk2-wiki][PATCH v1 0/4] Add new edk2 build instructions To: , CC: Sean Brogan , Michael D Kinney , Liming Gao , Chris Fernald References: <20221205161523.2627-1-mikuback@linux.microsoft.com> From: "Rebecca Cran" In-Reply-To: <20221205161523.2627-1-mikuback@linux.microsoft.com> X-Originating-IP: [10.80.80.8] X-ClientProxiedBy: nasanex01a.na.qualcomm.com (10.52.223.231) To nasanex01b.na.qualcomm.com (10.46.141.250) X-QCInternal: smtphost X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=5800 signatures=585085 X-Proofpoint-ORIG-GUID: iZd-ITsz9tjVc4lnbNRyBGwlrVPYP2ay X-Proofpoint-GUID: iZd-ITsz9tjVc4lnbNRyBGwlrVPYP2ay X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.923,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-12-05_01,2022-12-05_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 mlxscore=0 clxscore=1011 phishscore=0 lowpriorityscore=0 suspectscore=0 spamscore=0 priorityscore=1501 mlxlogscore=999 malwarescore=0 bulkscore=0 impostorscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2212050136 Content-Language: en-US Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 7bit Messages 1/4 and 4/4 are empty, and 2/4 seems to be missing. -- Rebecca Cran On 12/5/22 09:15, Michael Kubacki wrote: > From: Michael Kubacki > > This series adds a new set of build instructions and updates prior > instructions to point to the new version. > > Background > ---------- > Over the life of the project, EDK II has evolved it's build process. > > A common theme has been reducing the number of manual steps involved > and easing environment setup and configuration so developers can more > quickly get started writing firmware code. > > There's currently three general approaches to build: > > 1. [Containers](How-to-Develop-With-Containers.md) > 2. [Stuart](How-to-Build-With-Stuart.md) > 3. [build](Getting-Started-with-EDK-II.mediawiki) > > Prior documentation focuses on directly calling build (3). The new > documentation focuses on (1) and (2) but all of the instructions for > (3) are left intact. > > This is especially important given the transition to container based > builds on CI and introduction of more CI checks. > > Changes > ------- > Adds new documentation that describes containers and how to manually > set up a build environment using Stuart. > > Containers document covers: > > - Container background > - Docker background and installation > - Local development with containers > - How to manually configure a container > - Integration with VS Code > - Containers in pipelines > > Stuart build background covers: > > - Pre-requisites - Git, Python, compilers, SDKs, etc. > - Initial steps - Cloning the repo, set up Python virtual env, etc. > - Stuart command explanation and corresponding examples > - Common developer scenarios with examples showing what to do > - Common questions section with answers > > In addition, a "top-level" document is added that is main landing > page for references to build instructions that briefly describes the > three approaches with links to each. > > This is starting material for these topics, we plan to work with > the community to evolve them over time. > > Cc: Sean Brogan > Cc: Michael D Kinney > Cc: Liming Gao > Cc: Chris Fernald > Signed-off-by: Michael Kubacki > > Chris Fernald (1): > Add initial container usage instructions > > Michael Kubacki (3): > Add initial How to Build with Stuart Document > Add top-level build instructions file > Update existing build instructions > > Build-Instructions.md | 35 + > Build.mediawiki | 33 +- > BuildTool-Setup-Guide.mediawiki | 19 +- > Common-instructions-for-Unix.mediawiki | 7 +- > Common-instructions.mediawiki | 5 + > Getting-Started-with-EDK-II.mediawiki | 16 +- > How-to-Build-With-Stuart.md | 720 ++++++++++++++++++++ > How-to-Develop-With-Containers.md | 120 ++++ > UDK2017-How-to-Build.md | 30 +- > UDK2018-How-to-Build.md | 34 +- > Unix-like-systems.mediawiki | 7 +- > Using-EDK-II-with-Native-GCC.mediawiki | 13 +- > Windows-systems.mediawiki | 26 +- > 13 files changed, 993 insertions(+), 72 deletions(-) > create mode 100644 Build-Instructions.md > create mode 100644 How-to-Build-With-Stuart.md > create mode 100644 How-to-Develop-With-Containers.md >