Re: [xml2rfc] Novice bad user on device, or Catch-22?

Sandy Ginoza <sginoza@amsl.com> Tue, 21 January 2020 17:03 UTC

Return-Path: <sginoza@amsl.com>
X-Original-To: xml2rfc@ietfa.amsl.com
Delivered-To: xml2rfc@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7831E120804 for <xml2rfc@ietfa.amsl.com>; Tue, 21 Jan 2020 09:03:03 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.199
X-Spam-Level:
X-Spam-Status: No, score=-4.199 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, 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 ntnD9zHV0svz for <xml2rfc@ietfa.amsl.com>; Tue, 21 Jan 2020 09:02:58 -0800 (PST)
Received: from mail.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 4CD5512024E for <xml2rfc@ietf.org>; Tue, 21 Jan 2020 09:02:54 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id E28E22032BC; Tue, 21 Jan 2020 09:01:05 -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 I60X4_IFDaHj; Tue, 21 Jan 2020 09:01:05 -0800 (PST)
Received: from [IPv6:2605:e000:1524:de:4431:ee23:764e:1ac0] (unknown [IPv6:2605:e000:1524:de:4431:ee23:764e:1ac0]) by c8a.amsl.com (Postfix) with ESMTPSA id A0020202EF6; Tue, 21 Jan 2020 09:01:05 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
From: Sandy Ginoza <sginoza@amsl.com>
In-Reply-To: <ffabdb16-89af-2f62-8d2e-db080a73d7ec@alum.mit.edu>
Date: Tue, 21 Jan 2020 09:02:52 -0800
Cc: xml2rfc@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <21C39653-A1B9-4225-9406-681218978FDA@amsl.com>
References: <87E86D51-F37A-4800-BC14-6AA7E5E7EA4A@orandom.net> <751dd301-a89b-13b2-27b4-16beaced5de3@levkowetz.com> <DA4F22F5-5A43-4671-B69B-EDF61F976623@orandom.net> <61971d80-1c1e-bdf7-a986-0cfe9de157e6@levkowetz.com> <6C8FDE4E-88F8-4862-A9CC-3D1E9B0DCD4C@orandom.net> <fe468ed5-3d9b-88b2-8403-f8482bb1f55b@levkowetz.com> <647a593e-8104-0a59-bd0b-fb377f49201e@levkowetz.com> <A6C1B0DF-EAE0-46DC-9539-F56A3192E336@orandom.net> <43f689a4-7bc5-5e8c-0ca6-0ca785a77c8e@levkowetz.com> <7FAEB626-F120-4A03-91D8-F3FE6FE26001@orandom.net> <ffabdb16-89af-2f62-8d2e-db080a73d7ec@alum.mit.edu>
To: Paul Kyzivat <pkyzivat@alum.mit.edu>
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/jmt_HVklqyqc14g1qv36zJHkZog>
Subject: Re: [xml2rfc] Novice bad user on device, or Catch-22?
X-BeenThere: xml2rfc@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: <xml2rfc.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc/>
List-Post: <mailto:xml2rfc@ietf.org>
List-Help: <mailto:xml2rfc-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 21 Jan 2020 17:03:04 -0000

Hi all,

You may find some of the XML files in <https://www.rfc-editor.org/rfc/prerelease/> helpful.  These are the v3 XML files for the RFCs before they are run through the final “prep” tool (see https://tools.ietf.org/html/rfc7998). 

I suggest reviewing some of the more recently published RFCs for better examples.  

Thanks,
Sandy 



> On Jan 21, 2020, at 8:34 AM, Paul Kyzivat <pkyzivat@alum.mit.edu> wrote:
> 
> On 1/21/20 8:37 AM, David R. Oran wrote:
>> On 21 Jan 2020, at 3:26, Henrik Levkowetz wrote:
>>> Hi Dave,
>>> 
>> [snipping out to get to your question]
>>> On 2020-01-21 06:51, David R. Oran wrote:
>>> 
>>> And yes, having v3 templates would be helpful.  I'll see if I can fix that
>>> too.  Where would you normally grab a template?
>>> 
>> well, by googling :-)
>> Probably the home ought to be off the tools home page at tools.ietf.org. There’s already a “templates” link on that page - it’s to Elwyn Davies examples, and ought to have a V3 template.
> 
> I've just been lurking, but seems like a good time to comment...
> 
> I normally get my "template" by starting with some similar document, either one of my own if I have a suitable one, or from some document I am generally aware of.
> 
> But that doesn't work well now when there aren't many v3 documents to crib from.
> 
> I guess I would be inclined to grab the v2 for some similar document and convert it. But I guess maybe that won't give optimal style for the new document. So maybe having a recommended source of pure templates and also some "real" documents that are judged to be "good" examples would be helpful.
> 
> 	Thanks,
> 	Paul
> 
> _______________________________________________
> xml2rfc mailing list
> xml2rfc@ietf.org
> https://www.ietf.org/mailman/listinfo/xml2rfc