anchor.diff:  
   === Other installation options
   
  -* {uri-install-doc}[Installing the Asciidoctor toolchain]
  +* {uri-install-docker}[Installing Asciidoctor using Docker]
   * {uri-install-osx-doc}[Installing Asciidoctor on Mac OS X]
  +// at the moment, the following entry is just a reiteration of the information in this README
  +//* {uri-install-doc}[Installing the Asciidoctor toolchain]
   
   == Usage
   
  
positive.code: 
  == AsciiDoc Processing
  
  Asciidoctor reads and parses text written in the AsciiDoc syntax, then feeds the parse tree into a set of built-in templates to produce HTML5, DocBook 5 (or 4.5).
  You have the option of writing your own converter or providing {uri-tilt}[Tilt]-supported templates to customize the generated output or produce alternative formats.
  
  NOTE: Asciidoctor is a drop-in replacement for the original AsciiDoc Python processor (`asciidoc.py`).
  The Asciidoctor test suite has {uri-tests}[> 1,600 tests] to ensure compatibility with the AsciiDoc syntax.
  
  In addition to the standard AsciiDoc syntax, Asciidoctor recognizes additional markup and formatting options, such as font-based icons (e.g., `+icon:fire[]+`) and UI elements (e.g., `+button:[Save]+`).
  Asciidoctor also offers a modern, responsive theme based on {uri-foundation}[Foundation] to style the HTML5 output.
  
  == Requirements
  
negative.code: :uri-rubygem: https://rubygems.org/gems/asciidoctor
  :uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
  :uri-user-manual: {uri-docs}/user-manual
  :uri-install-docker: https://github.com/asciidoctor/docker-asciidoctor
  //:uri-install-doc: {uri-docs}/install-toolchain
  :uri-install-osx-doc: {uri-docs}/install-asciidoctor-macosx
  :uri-render-doc: {uri-docs}/render-documents
  :uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
  