[Xml-sg-cmt] topics 2021-03-01
Peter Saint-Andre <stpeter@mozilla.com> Mon, 01 March 2021 16:34 UTC
Return-Path: <stpeter@mozilla.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 1F0F43A1F14 for <xml-sg-cmt@ietfa.amsl.com>; Mon, 1 Mar 2021 08:34:01 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=mozilla.com
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 U7LNQtqXkVGs for <xml-sg-cmt@ietfa.amsl.com>; Mon, 1 Mar 2021 08:33:59 -0800 (PST)
Received: from mail-il1-x12a.google.com (mail-il1-x12a.google.com [IPv6:2607:f8b0:4864:20::12a]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E14C63A1F24 for <xml-sg-cmt@ietf.org>; Mon, 1 Mar 2021 08:33:58 -0800 (PST)
Received: by mail-il1-x12a.google.com with SMTP id z9so4915638iln.1 for <xml-sg-cmt@ietf.org>; Mon, 01 Mar 2021 08:33:58 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mozilla.com; s=google; h=to:from:subject:message-id:date:user-agent:mime-version :content-language:content-transfer-encoding; bh=nlDMUPBAvZ8JM5KGp0K1pxVTEfm0BPtbYVgjzgJ6zNc=; b=XbxrcskpduPq23bKlyhwyLwhucQ84HOP59CaG9S+32DMwQeUsBI22vCw1G/akxnGP/ ZJbSmIrIjb5JuQVSO1r6iw4MIHaAkzxOhnITybPdubZIZehth4ntFTXxvWNuJV6wi1nR E65BNIRLiPBccGpRikO6Gbji6W2HKiGfjHMCM=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:subject:message-id:date:user-agent :mime-version:content-language:content-transfer-encoding; bh=nlDMUPBAvZ8JM5KGp0K1pxVTEfm0BPtbYVgjzgJ6zNc=; b=h31SAS27UUBgJS2LbRqNNtRmjm+JfyyhwANJqWFcWrxGvgoHObwr1c8konzKz+X1K2 +9RXpFVY5SoalW1f6WAXwQrG5TUcz/vOKCd551vhWFs1lDXImzIWrTU69a/gOJ+uG/Id hHxos66ynf71JgJ/8V+lyjahLYwAaib5XACxDa6zwgFjeLeEpfNIv+p9+rPdDn0l5PIb 44ADdxDWgpj9R2ZmAH6arkuJGAxIxhgYwvn1yFzLA1NXTHqdljhh4hTP7oJCZqdkBcyf xKaB6X1l0K8HzNq6V6wCki+y0dcN51kCKUe9F0SJwVqToGYQgt/IEnjI0+6OO/lslTme RblA==
X-Gm-Message-State: AOAM531FX5DrcZ+AZrmMcvGqmwyaaVLA2BrHpG77VdtOP4jyotZUcW+k oTfuaXpnNKLEf4usyOVWi3a1BQ==
X-Google-Smtp-Source: ABdhPJy4XmbDM3HBVq19MBkdV/GHjQPeVdYDdXPDmZwHzVIALmj0dx7VTQiSkR7cAzVFkmt/3PdwEA==
X-Received: by 2002:a05:6e02:1908:: with SMTP id w8mr13184998ilu.235.1614616436779; Mon, 01 Mar 2021 08:33:56 -0800 (PST)
Received: from dragon.local ([76.25.3.152]) by smtp.gmail.com with ESMTPSA id s16sm334092ioe.44.2021.03.01.08.33.56 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 01 Mar 2021 08:33:56 -0800 (PST)
To: XML weed whackers <xml-sg-cmt@ietf.org>
From: Peter Saint-Andre <stpeter@mozilla.com>
Message-ID: <fb597b6f-5f29-9f16-3355-62c0067845a2@mozilla.com>
Date: Mon, 01 Mar 2021 09:33:55 -0700
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.16; rv:78.0) Gecko/20100101 Thunderbird/78.7.1
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/CXGVp_f0lx5nedM7HvK6TPi2UHQ>
Subject: [Xml-sg-cmt] topics 2021-03-01
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: Mon, 01 Mar 2021 16:34:01 -0000
Welcome to March! Here are some potential topics for today: 0. Action items from last week: https://codimd.ietf.org/cmt-20210222# (I have yet to complete mine, sorry about that!) 1. Closing out on artwork vs. sourcecode Further commentary at https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/195 indicates continued confusion about whether the contents of the sourcecode element may/should/must be machine readable. If we cleave to the distinction between artwork as visually significant and sourcecode as everything else, then machine readability should not matter. Let's discuss. 2. Where things get documented Alice, Sandy, and I had a chat last week about the various locations where we document things. It would be good for us all to be clear on what gets documented where, so that we can point people (authors, RPC staff, etc.) to the right places. Here is an initial suggestion: - 7991 + 7991bis - this is for official documentation of the schema - 7991bis should be updated to reflect decisions we've reached on this team and in the community (rfc-interest, GitHub) - xml2rfc doc, i.e., https://xml2rfc.tools.ietf.org/xml2rfc-doc.html - this provides a snapshot of what the tool supports, but it's not authoritative regarding the schema and thus 7991bis should be updated as noted above - xml2rfc FAQ, i.e., https://xml2rfc.tools.ietf.org/xml2rfcFAQ.html - this answers questions about authoring documents with the tool and includes helpful examples, but does not provide authoritative schema documentation - RFC Style Guide in its various guises current: https://www.rfc-editor.org/rfc/rfc7322 future: https://datatracker.ietf.org/doc/draft-flanagan-7322bis/ web: https://www.rfc-editor.org/styleguide/part2/ - this covers editorial and authorial issues but shouldn't cover technical/schema/tooling issues Let's discuss this as well. :-) If we finish with those topics, we can move on to a few things we didn't get to last time... 3. table in dd https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/186 I haven't found the discussion of this on list or in Subversion. 4. dl hanging https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/171 https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/38 I think this is "Will Document" 5. ul@bare https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/169 https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/547 6. ul and dl indentation https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/191 /psa
- [Xml-sg-cmt] topics 2021-03-01 Peter Saint-Andre
- Re: [Xml-sg-cmt] topics 2021-03-01 Peter Saint-Andre