SVG Drawings for RFCs: SVG 1.2 RFC
RFC 7996

Document Type RFC - Informational (December 2016; No errata)
Last updated 2016-12-16
Replaces draft-brownlee-svg-rfc
Stream IAB
Formats plain text pdf html bibtex
Reviews
Stream IAB state Published RFC
Consensus Boilerplate Yes
RFC Editor Note (None)
Internet Architecture Board (IAB)                            N. Brownlee
Request for Comments: 7996                    The University of Auckland
Category: Informational                                    December 2016
ISSN: 2070-1721

                   SVG Drawings for RFCs: SVG 1.2 RFC

Abstract

   This document specifies SVG 1.2 RFC -- an SVG profile for use in
   diagrams that may appear in RFCs -- and considers some of the issues
   concerning the creation and use of such diagrams.

Status of This Memo

   This document is not an Internet Standards Track specification; it is
   published for informational purposes.

   This document is a product of the Internet Architecture Board (IAB)
   and represents information that the IAB has deemed valuable to
   provide for permanent record.  It represents the consensus of the
   Internet Architecture Board (IAB).  Documents approved for
   publication by the IAB are not a candidate for any level of Internet
   Standard; see Section 2 of RFC 7841.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc7996.

Copyright Notice

   Copyright (c) 2016 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.

Brownlee                      Informational                     [Page 1]
RFC 7996           SVG Drawings for RFCs: SVG 1.2 RFC      December 2016

Table of Contents

   1. Introduction ....................................................2
   2. SVG 1.2 RFC: An SVG Profile for RFCs ............................3
      2.1. Elements, Properties, and Attributes Allowed in
           SVG 1.2 RFC ................................................4
   3. How to Create SVG Drawings ......................................7
   4. Accessibility Considerations ....................................7
   5. Examples of Diagrams Common in RFCs .............................8
      5.1. Packet Layout Diagrams .....................................8
      5.2. Sequence Diagrams (1) ......................................8
      5.3. Sequence Diagrams (2) ......................................8
   6. Security Considerations .........................................8
   7. References ......................................................9
      7.1. Normative References .......................................9
      7.2. Informative References .....................................9
   Appendix A. RELAX NG Compact (RNC) Schema for SVG 1.2 RFC .........11
   IAB Members at the Time of Approval ...............................53
   Acknowledgements ..................................................53
   Author's Address ..................................................53

1.  Introduction

   Over the last few years, the RFC Editor has worked with the Internet
   community to develop specifications for changes in the format of
   RFCs.  An outline of the resulting specifications was published as
   [RFC6949] in May 2013.  Since then, a Design Team has been working
   with the RFC Editor to flesh out those specifications.  One aspect of
   the changes is to allow line drawings in RFCs; [RFC6949] says

      Graphics may include ASCII art and a more complex form to be
      defined, such as SVG line art [SVG].  Color and grayscale will not
      be accepted.  RFCs must correctly display in monochromatic black-
      and-white to allow for monochrome displays, black-and-white
      printing, and support for visual disabilities.

   SVG (Scalable Vector Graphics) has been developed by W3C, the World
   Wide Web Consortium; its current standard is SVG 1.1 Full
   [W3C.REC-SVG11-20110816].  This document defines SVG 1.2 RFC, an SVG
   profile (i.e., a subset of SVG) that is suitable for RFC line
   drawings.

   Note that in RFCs, the text provides normative descriptions of
   protocols, systems, etc.  Diagrams may be used to help explain
   concepts more clearly, but they provide supporting details and should
   not be considered to be complete specifications in themselves.

Brownlee                      Informational                     [Page 2]
RFC 7996           SVG Drawings for RFCs: SVG 1.2 RFC      December 2016

   The details (particularly any vocabularies) described in this
   document are expected to change based on experience gained in
   implementing the new publication toolsets.  Revised documents will be
Show full document text