Align behaviour between bundle exec rdoc and rake rdoc (#1156)

* Align behaviour between `bundle exec rdoc` and `rake rdoc`

By using `.rdoc_options` to specify the RDoc options, we can make most
of the rake task options the in-repo defaults.

This allows us to use the same options for both `bundle exec rdoc` and
`rake rdoc` and get a consistent experience.

* Apply suggestions from code review

Co-authored-by: Olle Jonsson <olle.jonsson@gmail.com>

---------

Co-authored-by: Olle Jonsson <olle.jonsson@gmail.com>

.document

@@ -1,7 +1,7 @@
 History.txt
 LICENSE.txt
 README.txt
-RI.txt
-RI.md
+*.md
+*.rdoc
 lib
 doc

.rdoc_options

@@ -0,0 +1,8 @@
+exclude:
+  - lib/rdoc/rd/block_parser.ry
+  - lib/rdoc/rd/inline_parser.ry
+  - lib/rdoc/markdown.kpeg
+  - lib/rdoc/markdown/literals.kpeg
+op_dir: _site # for GitHub Pages and should match the config of RDoc task in Rakefile
+title: rdoc Documentation
+main_page: README.rdoc

Rakefile

@@ -21,10 +21,8 @@ task :default => :test
 
 task rdoc: :generate
 RDoc::Task.new do |doc|
-  doc.main = 'README.rdoc'
-  doc.title = "rdoc #{RDoc::VERSION} Documentation"
-  doc.rdoc_dir = '_site' # for github pages
-  doc.rdoc_files = FileList.new %w[lib/**/*.rb *.rdoc *.md doc/rdoc/markup_reference.rb] - PARSER_FILES
+  # RDoc task defaults to /html and overrides the op_dir option in .rdoc_options
+  doc.rdoc_dir = "_site" # for GitHub Pages
 end
 
 task "coverage" do