From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182])
 by mx.groups.io with SMTP id smtpd.web11.15074.1670509270859385516
 for <devel@edk2.groups.io>;
 Thu, 08 Dec 2022 06:21:10 -0800
Authentication-Results: mx.groups.io;
 dkim=pass header.i=@linux.microsoft.com header.s=default header.b=Bd6L+lVH;
 spf=pass (domain: linux.microsoft.com, ip: 13.77.154.182, mailfrom: mikuback@linux.microsoft.com)
Received: from [192.168.4.22] (unknown [47.201.8.94])
	by linux.microsoft.com (Postfix) with ESMTPSA id B0B9720B83E2;
	Thu,  8 Dec 2022 06:21:09 -0800 (PST)
DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com B0B9720B83E2
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com;
	s=default; t=1670509270;
	bh=N0D3ROwjqYsxClktuUYhTK71gm8yB2jQ5FasUk3gbrE=;
	h=Date:Subject:To:Cc:References:From:In-Reply-To:From;
	b=Bd6L+lVHlYyGRZHnsukmW2qEqXVV34NZbng2cckFl4VMHqtoFNE6QMYh0TzjHlIys
	 /dD+zLyDhqodFAQ6Li9PiIVSv0xx1Owsagn8HinrebWpbhIEFWtKwPcwBzTMQuZhGt
	 gk35jM/SOlh54xCKW9oROVXjRnmR3xbnRmaYp2dE=
Message-ID: <c47e517d-cac9-1a99-4d86-c355093385c4@linux.microsoft.com>
Date: Thu, 8 Dec 2022 09:21:08 -0500
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 6.2; Win64; x64; rv:91.0) Gecko/20100101
 Thunderbird/91.13.1
Subject: Re: [edk2-devel] [edk2-wiki][PATCH v3 1/4] Add initial How to Build with Stuart Document
To: devel@edk2.groups.io, quic_rcran@quicinc.com
Cc: Sean Brogan <sean.brogan@microsoft.com>,
 Michael D Kinney <michael.d.kinney@intel.com>,
 Liming Gao <gaoliming@byosoft.com.cn>
References: <20221207162403.337-1-mikuback@linux.microsoft.com>
 <20221207162403.337-2-mikuback@linux.microsoft.com>
 <e3bec8ba-18f8-fc40-7241-d3e90107e0cb@quicinc.com>
From: "Michael Kubacki" <mikuback@linux.microsoft.com>
In-Reply-To: <e3bec8ba-18f8-fc40-7241-d3e90107e0cb@quicinc.com>
Content-Language: en-US
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

I write it by hand. HTML comes in because I'm using collapsing content 
via <summary> 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 (<strong> -> **, <a> -> [](), <code> -> ``, 
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 "<strong>C Compiler</strong>" - I'd expect something 
> like "**C Compiler**" instead.
>