The Ops area aims to be very friendly. We don't always succeed, but we try to make newcomers feel welcome.
We've started an Ops reading / book recommendation list here. These are just a set of books that we'd found interesting / useful, and figured that you might enjoy too...
Warren Kumari and Rob Wilton hold irregular on-line office hours.
The schedule is posted at the URL below:
The below are some things to consider and keep in mind while writing Internet Drafts, both in the Operations and Management area, but also in the IETF in general.
There are many ways to shoot yourself in the foot when writing an Internet Draft - here are some of the ways that the current AD has seen this happen and / or things which it is worth keeping in mind.
Note that these are just the personal views and advice from the current OpsAD - it is far from complete, feel free to send me additional pointers / ways which you've seen people trip over operational bits.
RFC 5706 Appendix A. - "Guidelines for Considering Operations and Management of New Protocols and Protocol Extensions" (https://tools.ietf.org/html/rfc5706) contains a checklist which is also very helpful.
DNS is core plumbing, and as such it is one of the obvious tools in the protocol designer's toolbox. There are, however, a number of dangers here.
In forthcoming MIB reviews the MIB Doctors will be applying these Guidelines for Authors and Reviewers of MIB Documents [RFC4181, BCP111]", (RFC issued September 23rd, 2005). These guidelines have been updated by an IESG approved document: "RFC 4181 Update to Recognize the IETF Trust [RFC4841, BCP111]".
For your convenience:
Boilerplate for MIB documents
Guidelines for a MIB security section
Generic and Common Textual Conventions
MIB review tools
There is a text template you can use to start a document containing a MIB module that helps you meet many of the requirements listed in RFC4181 "Guidelines for Authors and Reviewers of MIB Documents" and also is designed to meet the preferences of the MIB Doctors for section ordering and naming to simplify automated checking. See RFC 5249 - Templates for Internet-Drafts Containing MIB Modules.
The XML source for generating the text template with the xml2rfc tool is also available. The XML source includes additional comments that can help an author fill in the various sections appropriately using an XML editor. The XML source is contained in An XML Template for Documents Containing a MIB Module. Viewing the XML source in your XML editor may require having an rfc2629.dtd from xml.resource.org.
Updated templates (June 2013), by David B. Harrington, can be found here.
The MIB Doctors have produced three templates specifically aimed at drafts containing MIB modules:
In forthcoming YANG reviews the YANG Doctors will be applying the Guidelines for Authors and Reviewers of YANG Data Model Documents (RFC 6087).
For your convenience:
YANG module security guidelines
(16 June 2010, approved by Security ADs, updated 22 March 2012).
List of YANG typedefs.
The content of this page was last updated on 2022-03-23. It was migrated from the old Trac wiki on 2022-12-19.