Convert to AsciiDoc

AsciiDoc allows us to have native admonitions, footnotes, sane nesting
of list items, etc and to easily export the guide in various formats.
That would also make it trivial to publish a simple site from the guide
down the road if we want to.

A longer term plan is to convert all guides to AsciiDoc and maybe even
RuboCop's own documentation. RSpec and Rails style guides have been recently
converted:
  - rubocop/rspec-style-guide#97
  - rubocop/rails-style-guide#250

Author: pirj

.gitattributes

@@ -1 +1 @@
-*.md whitespace=trailing-space,tab-in-indent
+*.adoc whitespace=trailing-space,tab-in-indent

.gitignore

@@ -0,0 +1,2 @@
+README.html
+README.pdf