Re: [Xml-sg-cmt] is "example" an acceptable type within <artwork>

Sandy Ginoza <sginoza@amsl.com> Fri, 04 March 2022 23:07 UTC

Return-Path: <sginoza@amsl.com>
X-Original-To: xml-sg-cmt@ietfa.amsl.com
Delivered-To: xml-sg-cmt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 862783A07F3 for <xml-sg-cmt@ietfa.amsl.com>; Fri, 4 Mar 2022 15:07:58 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.909
X-Spam-Level:
X-Spam-Status: No, score=-6.909 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_HI=-5, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Yddp-fYmjmY2 for <xml-sg-cmt@ietfa.amsl.com>; Fri, 4 Mar 2022 15:07:53 -0800 (PST)
Received: from c8a.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id B977E3A118D for <xml-sg-cmt@ietf.org>; Fri, 4 Mar 2022 15:07:44 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id AAF08425C195; Fri, 4 Mar 2022 15:07:44 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from c8a.amsl.com ([127.0.0.1]) by localhost (c8a.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id kIzGzMEaA1CQ; Fri, 4 Mar 2022 15:07:44 -0800 (PST)
Received: from smtpclient.apple (2603-8000-9603-b513-c4a5-1517-daf5-8d01.res6.spectrum.com [IPv6:2603:8000:9603:b513:c4a5:1517:daf5:8d01]) by c8a.amsl.com (Postfix) with ESMTPSA id 8E8A5425A344; Fri, 4 Mar 2022 15:07:44 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\))
From: Sandy Ginoza <sginoza@amsl.com>
In-Reply-To: <B79AF33A-DE79-4E04-898E-F4632C4D672C@amsl.com>
Date: Fri, 04 Mar 2022 15:07:43 -0800
Cc: rfc-editor-bounces@rfc-editor.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <C076FAEF-6E70-40DF-BF89-F030308FBE69@amsl.com>
References: <b749b97d-9a78-bf28-50be-baaec9e86e93@greenbytes.de> <C243E539-F02B-48B5-9AFB-DFEBB9914DE6@amsl.com> <B79AF33A-DE79-4E04-898E-F4632C4D672C@amsl.com>
To: xml-sg-cmt@ietf.org
X-Mailer: Apple Mail (2.3654.120.0.1.13)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/2cHkTPohCWuCDKzfB5qzVkmuwDQ>
Subject: Re: [Xml-sg-cmt] is "example" an acceptable type within <artwork>
X-BeenThere: xml-sg-cmt@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Working list for the xml and style guide change management team <xml-sg-cmt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml-sg-cmt/>
List-Post: <mailto:xml-sg-cmt@ietf.org>
List-Help: <mailto:xml-sg-cmt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 04 Mar 2022 23:07:59 -0000

Hi Lynne, xml-sg-cmt,

> In the case of both <artwork> and <sourcecode>, is it OK for authors to use whatever type they deem appropriate for their document, even if the type isn't used or listed anywhere else?

Based on John’s reply, I believe artwork types should only be svg, ascii-art, or empty.  <sourcecode> types are being vetted by xml-sg-cmt before being added to the list.  

For sourcecode type=“example” or type=“drawing” - I expect that the options are:
- specify the type of code 
- leave type empty
- use <artwork>

Is this correct?  Or are these values acceptable sourcecode types? 

Thanks,
Sandy 

> On Mar 3, 2022, at 6:45 PM, Lynne Bartholomew <lbartholomew@amsl.com> wrote:
> 
> Hi, KC and everyone.
> 
> Thank you for sending this to <xml-sg-cmt@ietf.org>, KC!  A similar question came up for me as well -- this time for <sourcecode>.
> 
> draft-ietf-httpbis-priority-12 has four <sourcecode> entries with type="example" and two with type="drawing", so I asked the authors if they would like to request that type="example" and type="drawing" be added to the list of usable sourcecode types on <https://www.rfc-editor.org/materials/sourcecode-types.txt> (because I was under the impression that if a type isn't explicitly listed as acceptable, it shouldn't be used unless someone decides to add it to the list in question, i.e., <artwork> or <sourcecode>).
> 
> In the case of both <artwork> and <sourcecode>, is it OK for authors to use whatever type they deem appropriate for their document, even if the type isn't used or listed anywhere else?
> 
> Thanks again.
> 
> Lynne
> 
>> On Mar 3, 2022, at 5:17 PM, Karen Moore <kmoore@amsl.com> wrote:
>> 
>> Hi team,
>> 
>> In RFC-to-be 9112 (which is currently in AUTH48), Julian would like to set the type to “example” within the <artwork> elements (since they are not ascii-art).  Is this acceptable, or do you see any issues with this? There are three instances in the text.
>> 
>> One example
>> 
>> Old:
>>   <artwork type=“ascii-art"><![CDATA[
>>    https://www.example.org/pub/WWW/TheProject.html
>>    ]]></artwork>
>> 
>> New:
>>   <artwork type=“example"><![CDATA[
>>   https://www.example.org/pub/WWW/TheProject.html
>>   ]]></artwork>
>> 
>> 
>> The files are here:
>> https://www.rfc-editor.org/authors/rfc9112.txt
>> https://www.rfc-editor.org/authors/rfc9112.pdf
>> https://www.rfc-editor.org/authors/rfc9112.html
>> https://www.rfc-editor.org/authors/rfc9112.xml
>> 
>> Thanks,
>> Karen
>> 
>>> Begin forwarded message:
>>> 
>>> From: Julian Reschke <julian.reschke@greenbytes.de>
>>> Subject: Re: AUTH48 [KC]: RFC 9112 <draft-ietf-httpbis-messaging-19.txt> NOW AVAILABLE
>>> Date: March 1, 2022 at 11:47:25 AM PST
>>> To: Karen Moore <kmoore@amsl.com>, "Roy T. Fielding" <fielding@gbiv.com>, Mark Nottingham <mnot@mnot.net>
>>> Cc: httpbis-chairs@ietf.org, httpbis-ads@ietf.org, Tommy Pauly <tpauly@apple.com>, "rfc-editor@rfc-editor.org" <rfc-editor@rfc-editor.org>
>>> 
>>> Am 11.02.2022 um 20:21 schrieb Karen Moore:
>>>> ...
>>> 
>>> Hi Karen,
>>> 
>>> I found three cases where we have examples in <artwork> elements, and none of these cases are "ascii-art". Please revert (or apply attached XML).
>>> 
>>> Best regards, Julian
>> <rfc9112-to-be.xml>
>> 
>> 
> 
> -- 
> Xml-sg-cmt mailing list
> Xml-sg-cmt@ietf.org
> https://www.ietf.org/mailman/listinfo/xml-sg-cmt