Re: [111attendees] New Email - Please kindly guide me, Thanks

John C Klensin <john-ietf@jck.com> Tue, 27 July 2021 05:47 UTC

Return-Path: <john-ietf@jck.com>
X-Original-To: 111attendees@ietfa.amsl.com
Delivered-To: 111attendees@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9884F3A126D for <111attendees@ietfa.amsl.com>; Mon, 26 Jul 2021 22:47:53 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_NONE=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 81Uc1YWBO8Zl for <111attendees@ietfa.amsl.com>; Mon, 26 Jul 2021 22:47:51 -0700 (PDT)
Received: from bsa2.jck.com (ns.jck.com [70.88.254.51]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 374DC3A1264 for <111attendees@ietf.org>; Mon, 26 Jul 2021 22:47:51 -0700 (PDT)
Received: from [198.252.137.10] (helo=PSB) by bsa2.jck.com with esmtp (Exim 4.82 (FreeBSD)) (envelope-from <john-ietf@jck.com>) id 1m8FwT-0005u4-8u; Tue, 27 Jul 2021 01:47:49 -0400
Date: Tue, 27 Jul 2021 01:47:43 -0400
From: John C Klensin <john-ietf@jck.com>
To: Brian E Carpenter <brian.e.carpenter@gmail.com>, Chukwuka Odele <chukwukaodele@gmail.com>, 111attendees@ietf.org
Message-ID: <8F693934B9A5F5F47D5B3748@PSB>
In-Reply-To: <6934e921-adec-0dfe-2092-f38f30a8a63d@gmail.com>
References: <CAGburNTD+3G6d2bMiJTUhCzjXhi1MDyywBxdP42ko19MaMLm3A@mail.gmail.com> <C4DE4E95047178C5947FA7ED@PSB> <6934e921-adec-0dfe-2092-f38f30a8a63d@gmail.com>
X-Mailer: Mulberry/4.0.8 (Win32)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
X-SA-Exim-Connect-IP: 198.252.137.10
X-SA-Exim-Mail-From: john-ietf@jck.com
X-SA-Exim-Scanned: No (on bsa2.jck.com); SAEximRunCond expanded to false
Archived-At: <https://mailarchive.ietf.org/arch/msg/111attendees/KjgVQJkpLvfvQRtHBfLsXwo_3u4>
Subject: Re: [111attendees] New Email - Please kindly guide me, Thanks
X-BeenThere: 111attendees@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Mailing list for IETF 111 attendees <111attendees.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/111attendees>, <mailto:111attendees-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/111attendees/>
List-Post: <mailto:111attendees@ietf.org>
List-Help: <mailto:111attendees-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/111attendees>, <mailto:111attendees-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 27 Jul 2021 05:47:54 -0000

Chuks,

Just to be sure there is no appearance of disagreement here, I
completely agree with everything Brian said below and appreciate
the additional explanation.  I might have said "start with
kramdown unless you are already familiar with SML and can find
an existing and fairly complete document for use as an example
or template" but, for most people, that amounts to the same
advice about kramdown that Brian gave.

   john

--On Tuesday, July 27, 2021 15:45 +1200 Brian E Carpenter
<brian.e.carpenter@gmail.com> wrote:

> Chuks,
> 
> I think there is something we lack (at least in up to date
> form), which is "How to write your first Internet-Draft".
> There are  certainly some tutorials at
> https://www.ietf.org/about/participate/tutorials/ but I think
> anyone starting today should probably start with kramdown.
> That minimises the amount of XML magic that you need to learn.
> 
> Amplifying what John said slightly, the first draft for a new
> idea is not a sales document, but it does need to indicate the
> use case (what technical gap is being filled) and the basic
> technical idea, and then expand the technical details enough
> to satisfy people that the idea is workable and secure. It's
> hard work.
> 
> A running prototype is always good, too.
> 
> If the way forward is eventually a working group, there are a
> lot more tricks to learn (such as how to have a successful BOF,
> see https://www.ietf.org/how/bofs/) but first you need to find
> out if there are other people interested in the work. That's
> the main purpose of the initial Internet-Draft and a discussion
> with DISPATCH.
> 
> Regards
>    Brian