From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from wout1-smtp.messagingengine.com (wout1-smtp.messagingengine.com [64.147.123.24]) by mx.groups.io with SMTP id smtpd.web10.66646.1670909128251466612 for ; Mon, 12 Dec 2022 21:25:28 -0800 Authentication-Results: mx.groups.io; dkim=fail reason="signature has expired" header.i=@bsdio.com header.s=fm3 header.b=Col3TqQi; spf=pass (domain: bsdio.com, ip: 64.147.123.24, mailfrom: rebecca@bsdio.com) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.west.internal (Postfix) with ESMTP id AD5B53200893; Tue, 13 Dec 2022 00:25:26 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Tue, 13 Dec 2022 00:25:27 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bsdio.com; h=cc :cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to; s=fm3; t=1670909126; x= 1670995526; bh=7z1ZEL5Mg7h/0oDdLeeGbLxZLOWTsQaZu9gJj52zqWc=; b=C ol3TqQiEt4hiD//brfU8+uXUJiI4WEsf6e6jVXiF3QzX1HBQs4bwowNVM/JzBxkB Jl59qwIAGdV8e5ItN+n0lCUOmXxmYV1QZqGlH3unUlEd+XRAxoa277EaU3jl7Aw+ JIMiVPHdSQktusdlCYn31/D7Gz/1/cAr8jyUGe1Fh3F0avlkK3reL/lqdqBv2p7G zDNAuxhywpewNSqLM2gTe9hVD5SKe2nOR8ehdEMH3+606oLdSyP+GSLT3JDR0QYE K/tmIKv9K5ouvWzmMAmrx3RPd4ARLk6AixwpTO0V4vQvxcV3GiAlamMJZU5WQogs minbp4VNV8+KhRfIXGuEg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1670909126; x= 1670995526; bh=7z1ZEL5Mg7h/0oDdLeeGbLxZLOWTsQaZu9gJj52zqWc=; b=H bP4HYDuNFS6zHz0N6TVale4YKxND18/ycIKB8ccWRCZs+DvRozLyVqTZ4T/+L2EM zufjFdjI2iqMteG2L8L6oJTpYmilzVZ2Z4lsjYQmRExhLIFw1KlDpdHI5jFh6Nml qVNnXzLBbrLHMTg6Gy64qNV+e2W9LgQEIIOOSicyKCrfIlnsrvoJ+YCL9+CSqCS4 UILb9D7GCVcx4pGM5k7WZ7086cEJlMrWPIabmnalqPjUu+5v3MPuiNrdR3oxXhId RLmeLjSh+ftOdXMrPs8eWYJh/snjSOQl8s1WRoDYNMKHP3t/GFWq5yRhgNVxGL/Y J/QMsJU96WM883dv9Vzsg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvhedrvdelgdekhecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenog fuuhhsphgvtghtffhomhgrihhnucdlgeelmdenucfjughrpefkffggfgfuvfevfhfhjggt gfesthejredttdefjeenucfhrhhomheptfgvsggvtggtrgcuvehrrghnuceorhgvsggvtg gtrgessghsughiohdrtghomheqnecuggftrfgrthhtvghrnhepuddtudetfeeiteeuueet jeehhfduuedufffhvefhgefghedtvedufedtudffhedunecuffhomhgrihhnpehgihhthh husgdrtghomhdpghhithhhuhgsrdhiohdpihhnthhordhlohgtrghlpdhgrhhouhhpshdr ihhonecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomheprh gvsggvtggtrgessghsughiohdrtghomh X-ME-Proxy: Feedback-ID: i5b994698:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 13 Dec 2022 00:25:24 -0500 (EST) Message-ID: Date: Mon, 12 Dec 2022 22:25:23 -0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.4.2 Subject: Re: [edk2-devel] [edk2-wiki][PATCH v3 1/4] Add initial How to Build with Stuart Document To: devel@edk2.groups.io, mikuback@linux.microsoft.com, quic_rcran@quicinc.com Cc: Sean Brogan , Michael D Kinney , Liming Gao References: <20221207162403.337-1-mikuback@linux.microsoft.com> <20221207162403.337-2-mikuback@linux.microsoft.com> From: "Rebecca Cran" In-Reply-To: Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit According to https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections, it looks like normal markdown _should_ apply within collapsed sections? I noticed a few problems with https://github.com/tianocore/tianocore.github.io/wiki/How-to-Build-With-Stuart : Example: git clone edk2 Should probably be: git clone https://github.com/tianocore/edk2.git The Linux instructions for creating a python virtual environment should probably be: python3 -m venv .venv Though I've been installing the stuart tools into ~/.local/bin which allows you to skip the step of using a virtual environment. Lastly, the Git Submodules step says to use --recursive, which I seem to recall other instructions suggesting _not_ to use, since it's not needed. -- Rebecca Cran On 12/8/22 07:21, Michael Kubacki wrote: > I write it by hand. HTML comes in because I'm using collapsing content > via sections. Once in those sections, normal markdown > formatting does not apply. I've limited HTML usage in those sections > to very simple tags that mostly map directly to features allowed in > markdown formatting as well ( -> **, -> [](), -> > ``, etc.) > > Thanks, > Michael > > On 12/7/2022 11:47 PM, Rebecca Cran wrote: >> What tool do you use to write the pages? >> >> It seems to be a mixture of markdown and HTML: for example I'm >> surprised to see things like "C Compiler" - I'd >> expect something like "**C Compiler**" instead. >> > > > > >