authors.ietf.org - new resource site for authors of Internet-Drafts

IETF Executive Director <exec-director@ietf.org> Thu, 10 March 2022 02:57 UTC

Return-Path: <exec-director@ietf.org>
X-Original-To: ietf-announce@ietfa.amsl.com
Delivered-To: ietf-announce@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B64873A109C for <ietf-announce@ietfa.amsl.com>; Wed, 9 Mar 2022 18:57:31 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.909
X-Spam-Level:
X-Spam-Status: No, score=-1.909 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, 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 b3aZYartCsm7 for <ietf-announce@ietfa.amsl.com>; Wed, 9 Mar 2022 18:57:27 -0800 (PST)
Received: from ietfx.ietf.org (ietfx.amsl.com [4.31.198.45]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 834783A1097 for <ietf-announce@ietf.org>; Wed, 9 Mar 2022 18:57:27 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by ietfx.amsl.com (Postfix) with ESMTP id 6DD2E4397749 for <ietf-announce@ietf.org>; Wed, 9 Mar 2022 18:57:27 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from ietfx.ietf.org ([4.31.198.45]) by localhost (ietfx.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id cUmp_dsynGgL for <ietf-announce@ietf.org>; Wed, 9 Mar 2022 18:57:27 -0800 (PST)
Received: from smtpclient.apple (219-88-179-249-adsl.sparkbb.co.nz [219.88.179.249]) by ietfx.amsl.com (Postfix) with ESMTPSA id 166E74397742 for <ietf-announce@ietf.org>; Wed, 9 Mar 2022 18:57:26 -0800 (PST)
From: IETF Executive Director <exec-director@ietf.org>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Reply-To: tools-discuss <tools-discuss@ietf.org>
Mime-Version: 1.0 (Mac OS X Mail 15.0 \(3693.40.0.1.81\))
Subject: authors.ietf.org - new resource site for authors of Internet-Drafts
Message-Id: <F3489457-EEAF-4583-8A25-2418A27563D5@ietf.org>
Date: Thu, 10 Mar 2022 15:57:24 +1300
To: IETF Announcement List <ietf-announce@ietf.org>
X-Mailer: Apple Mail (2.3693.40.0.1.81)
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-announce/cMhqiMNAzPIjk7mix-K1Xv8Vf2Y>
X-BeenThere: ietf-announce@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "IETF announcement list. No discussions." <ietf-announce.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-announce>, <mailto:ietf-announce-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf-announce/>
List-Post: <mailto:ietf-announce@ietf.org>
List-Help: <mailto:ietf-announce-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-announce>, <mailto:ietf-announce-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 10 Mar 2022 02:57:32 -0000

In late 2020/early 2021 we surveyed [1] Internet-Draft (I-D) authors and a key theme to emerge was that documentation and resources for authors were hard to use as they were distributed across multiple sites and often inconsistent or out of date.  To address this, a new central resource site, authors.ietf.org, has been developed that pulls together and updates the existing documentation as well as adding new documentation to fill known gaps.  

authors.ietf.org has been produced with significant input from the developers of I-D authoring tools, the Tools Team and the RFC Production Center (RPC).  It includes a new set of RFCXML templates for I-D authors that the RPC recommend are used going forward as they address many of the common issues they encounter.  

Work is still underway to remove and/or redirect overlapping documentation on other sites.

Initially, the site will be maintained as required by the Tools team, the IETF Administration LLC, and the RPC, but it is hoped that more and more of the site will be edited and updated by the community.  To that end, all of the pages are mirrored to a GitHub repository [2] and we welcome people adding issues and submitting pull requests.  General feedback to the tools-discuss list [3] is also welcome.


[1]  https://www.ietf.org/blog/results-and-analysis-of-the-survey-of-i-d-authors-on-formats-and-tools/
[2]  https://github.com/ietf-authors/authors.ietf.org
[3]  https://www.ietf.org/mailman/listinfo/tools-discuss

-- 
Jay Daley
IETF Executive Director
exec-director@ietf.org