From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-1.mimecast.com (us-smtp-1.mimecast.com [205.139.110.61]) by mx.groups.io with SMTP id smtpd.web12.3161.1587378614343141049 for ; Mon, 20 Apr 2020 03:30:15 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=h3RyZXEK; spf=pass (domain: redhat.com, ip: 205.139.110.61, mailfrom: lersek@redhat.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1587378613; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=9qb73Bu0PpLF2h29el4T3KXobejV5lEAYAJKxytQpLg=; b=h3RyZXEKAx4kC5lWzA/oYags5zN1x3bRHWKB00vgvrcr4FptHqEziIu/N2oLLoT3h6nKN5 /uCBJBP968YyXo3G3pYB+f6czpAiWSLQlBgxZea4YqG2VL5RzFrcrUDZ3x5LU/RfKsyKnv aW+zcyG52tud2E/vQnZ3L6v3sduwhP0= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-22-ro-YJdG1PVq4vMaopeghag-1; Mon, 20 Apr 2020 06:30:08 -0400 X-MC-Unique: ro-YJdG1PVq4vMaopeghag-1 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id BFCBE802685; Mon, 20 Apr 2020 10:30:07 +0000 (UTC) Received: from lacos-laptop-7.usersys.redhat.com (ovpn-114-228.ams2.redhat.com [10.36.114.228]) by smtp.corp.redhat.com (Postfix) with ESMTP id 7B67318A85; Mon, 20 Apr 2020 10:30:06 +0000 (UTC) Subject: Re: [edk2-devel] [PATCH v1 2/6] ArmVirtPkg: Add Platform CI and configuration for Core CI To: Ard Biesheuvel , devel@edk2.groups.io, sean.brogan@microsoft.com Cc: "Kinney, Michael D" References: From: "Laszlo Ersek" Message-ID: <1be6a25d-06e2-4109-8acf-0fe82d150af4@redhat.com> Date: Mon, 20 Apr 2020 12:30:05 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 04/19/20 11:35, Ard Biesheuvel wrote: > On 4/19/20 10:29 AM, Sean via groups.io wrote: >> Laszlo, >> >> Regarding your comments about disliking the verbosity of the markdown >> table/html table for build status both in Core Ci and now these >> Platform CI readme files. >> >> As a learning experience I updated the OvmfPkg readme to use >> reStructuredText instead of markdown.=C2=A0 Not sure if I like RST but i= t >> does allow the links to not be in html and supports directives so you >> can push all that text to end of the file. >> >> Do you like this enough that I should rework all three readmes and we >> should discuss if RST should be used instead of MD for the edk2 project? >> >> RST version: >> https://github.com/spbrogan/edk2/blob/PlatformAndCoreCIForOvmfArmVirtEmu= latorPackages_v8/OvmfPkg/README.rst >> >> MD version: >> https://github.com/spbrogan/edk2/blob/PlatformAndCoreCIForOvmfArmVirtEmu= latorPackages_v7/OvmfPkg/README-pytools.md >> >> >=20 > I think the rendered RST looks really good, and is perfectly usable as > plaintext too. AFAICT, we are not losing out on anything the v7 version > provided, right? If not, I am in favor of going with RST in this case, > which I suppose implies that I am in favor of permitting it in EDK2 for > purposes such as this one. >=20 > That does not necessarily imply that all markdown should be replaced > with RST. I'm perfectly happy letting them co-exist, and I don't have an > opinion on whether one should be recommended over the other, or which > that should have to be. >=20 >> This is really the last remaining issue for the PlatformCI patchset. >> >=20 > Agreed. This is converging really nicely. >=20 Agreed 100% on all counts. Thanks Laszlo