= PWG POLICY DOCUMENT TEMPLATE : PWG Policy =
:author: John Smith
:email: john.smith@pwg.org
:revnumber: 0.0.2
:revdate: 2020-09-16
:toc:
:homepage: https://www.pwg.org/

{revnumber} - {revdate}

Copyright © 2020 IEEE ISTO Printer Working Group. All Rights Reserved.

== Abstract ==
This PWG Policy document defines SOMETHING OR OTHER - WHAT IS IT?

This DRAFT PWG Policy document is available here:

* https://ftp.pwg.org/pub/pwg/general/wd/pwg-TEMPLATE-policy-20200916.adoc
* https://ftp.pwg.org/pub/pwg/general/wd/pwg-TEMPLATE-policy-20200916.html
* https://ftp.pwg.org/pub/pwg/general/wd/pwg-TEMPLATE-policy-20200916.pdf
* https://ftp.pwg.org/pub/pwg/general/wd/pwg-TEMPLATE-policy-20200916.txt


== Terminology ==

=== Normative Terminology ===
Capitalized terms, such as MUST, MUST NOT, RECOMMENDED, REQUIRED, SHOULD, SHOULD NOT, MAY, and OPTIONAL, have special meaning relating to conformance as defined in Key words for use in RFCs to Indicate Requirement Levels <<BCP14>>. The term CONDITIONALLY REQUIRED is additionally defined for a conformance requirement that applies when a specified condition is true.

The term DEPRECATED is used for previously defined and approved protocol elements that SHOULD NOT be used or implemented. The term OBSOLETE is used for previously defined and approved protocol elements that MUST NOT be used or implemented.

' By placing this here in the document, the Abstract will not be numbered
' Section numbers are only generated when rendered by Asciidoctor
:sectnums:

== Overview ==

To be discussed here:
* This
* That
* The other thing <<IANA-IPP>>


== References ==
[bibliography]

* [[[Asciidoctor]]] "Asciidoctor: A fast text processor & publishing toolchain for converting AsciiDoc to HTML5, DocBook & more", https://asciidocor.org

* [[[bcp14]]] S. Bradner, “Key words for use in RFCs to Indicate Requirement Levels", RFC 2119/RFC8174 / BCP 14, March 1997 and May 2017, https://tools.ietf.org/html/bcp14

* [[[IANA-IPP]]] "Internet Printing Protocol (IPP) Registrations", Internet Assigned Numbers Authority, https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml


== Appendix A: Rendering Asciidoc ==
_* REMOVE THIS BEFORE PUBLISHING THE FINAL REVISION *_

PWG Asciidoc documents are rendered to HTML and PDF using the Asciidoctor toolset <<Asciidoctor>>. The "asciidoctor" command is used to render to HTML. The "asciidoctor-pdf" command is used to render to PDF. To render to plain text, a text-based HTML browser such as w3m or lynx can process the HTML rendering. An example of rendering an Asciidoc document to HTML, PDF and plain text might look like this:

   $ asciidoctor pwg-TEMPLATE-policy-YYYYMMDD.adoc
   $ asciidoctor-pdf pwg-TEMPLATE-policy-YYYYMMDD.adoc
   $ w3m -cols 80 -dump pwg-TEMPLATE-policy-YYYYMMDD.html > pwg-TEMPLATE-policy-YYYYMMDD.txt
