anchor.diff:  
    $ sudo apt-get upgrade asciidoctor
   
  +// QUESTION Maybe we can move this note with the explanation on why using linux packages is better than gem ?
  +
   NOTE: The Fedora, Debian and Ubuntu packages will not be available right away after a release of the RubyGem.
   It may take several weeks before the packages become available for a new release.
   If you need the latest version immediately, use the +gem install+ option.
  
positive.code: [source]
  puts Asciidoctor.render '*This* is http://asciidoc.org[AsciiDoc]!', :header_footer => true,
     :template_dir => 'templates'
  
  The Document and Section templates should begin with +document.+ and +section.+, respectively.
  The file extension is used by Tilt to determine which view framework it will use to render the template.
  
negative.code: 
  == Upgrading
  
  // QUESTION Merge this section with "Installation" ? "Installing and upgrading"
  
  If you have an earlier version of Asciidoctor installed, you can update it using the +gem+ command:
  
   $ gem update asciidoctor
  
  // QUESTION Move this tip somewhere else to reduce the length of the README ? "See Troubleshooting" ?
  
  [TIP]
  --
  