Convert documentation files to Markdown (#697)

.document

 spec/**/*.rb
 lib/**/*.rb
 -
-README.rdoc
-CHANGELOG.rdoc
-TODO.rdoc
+README.md
+CHANGELOG.md
+TODO.md

AUTHORS.rdoc → AUTHORS.md

-== Authors
+## Authors
 
 - Original code by: Dave Thomas -- Pragmatic Programmers, LLC <http://agilewebdevelopment.com/plugins/annotate_models>
 - Overhauled by: Alex Chaffee <http://alexch.github.com> alex@stinky.com
@@ -6,7 +6,7 @@
 - Maintained by: Alex Chaffee and Cuong Tran
 - Homepage: http://github.com/ctran/annotate_models
 
-With help from:
+### With help from:
 
 - Jack Danger - http://github.com/JackDanger
 - Michael Bumann - http://github.com/bumi

RELEASE.md

+## Prerequisite 
+
+- Install "git-flow" (`brew install git-flow`)
+- Install "bump" gem (`gem install bump`)
+
+
+## Perform a release
+
+- `git flow release start <release>`
+- Update the `CHANGELOG.md` file
+- `bump current`
+- `bump patch`
+- `rm -rf dist`
+- `rake spec`
+- `rake gem`
+- `git flow release finish <release>`
+
+- `rake gem:publish`
+

RELEASE.rdoc

-== Prerequisite 
-
-- Install "git-flow" (brew install git-flow)
-- Install "bump" gem (gem install bump)
-
-== Perform a release
-
-- git flow release start <release>
-- Update the CHANGELOG.rdoc file
-- bump current
-- bump patch
-- rm -rf dist
-- rake spec
-- rake gem
-- git flow release finish <release>
-
-- rake gem:publish

Rakefile

@@ -60,7 +60,7 @@ namespace :gem do
       end
 
       gem.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
-      gem.extra_rdoc_files = ['README.rdoc', 'CHANGELOG.rdoc', 'TODO.rdoc']
+      gem.extra_rdoc_files = ['README.md', 'CHANGELOG.md', 'TODO.md']
 
       gem.files = `git ls-files -- .`.split("\n").reject do |fn|
         fn =~ /^Gemfile.*/ ||

TODO.rdoc → TODO.md

-== TODO
+## TODO
 
 - clean up history
 - change default position back to "top" for all annotations
 - change 'exclude' to 'only' (double negatives are not unconfusing)
 
-== TODO (proposed)
+## TODO (proposed)
 
 - push two identical gems, named 'annotate' and 'annotate_models'
 - supply two binaries, named 'annotate' and 'annotate_models', since there's already a unix tool named 'annotate'

annotate.gemspec

@@ -13,8 +13,8 @@ Gem::Specification.new do |s|
   s.description = 'Annotates Rails/ActiveRecord Models, routes, fixtures, and others based on the database schema.'
   s.email = ['alex@stinky.com', 'cuong.tran@gmail.com', 'x@nofxx.com', 'turadg@aleahmad.net', 'jon@cloudability.com']
   s.executables = ['annotate']
-  s.extra_rdoc_files = ['README.rdoc', 'CHANGELOG.rdoc', 'TODO.rdoc']
-  s.files = `git ls-files -z LICENSE.txt *.rdoc *.gemspec bin lib`.split("\x0")
+  s.extra_rdoc_files = ['README.md', 'CHANGELOG.md', 'TODO.md']
+  s.files = `git ls-files -z LICENSE.txt *.md *.gemspec bin lib`.split("\x0")
   s.homepage = 'http://github.com/ctran/annotate_models'
   s.licenses = ['Ruby']
   s.require_paths = ['lib']