aboutsummaryrefslogtreecommitdiffstats
path: root/rails.gemspec
diff options
context:
space:
mode:
authorXavier Noria <fxn@hashref.com>2015-02-06 20:06:29 +0100
committerXavier Noria <fxn@hashref.com>2015-02-06 21:04:54 +0100
commitcd7cc5254b090ccbb84dcee4408a5acede25ef2a (patch)
treec9a34b4bd12214ab8547ec341669775884e0508e /rails.gemspec
parent8c752c7ac739d5a86d4136ab1e9d0142c4041e58 (diff)
downloadrails-cd7cc5254b090ccbb84dcee4408a5acede25ef2a.tar.gz
rails-cd7cc5254b090ccbb84dcee4408a5acede25ef2a.tar.bz2
rails-cd7cc5254b090ccbb84dcee4408a5acede25ef2a.zip
Remove documentation tasks
This patch removes the tasks doc:app, doc:rails, and doc:guides. In our experience applications do not generate APIs using doc:app. Methods may be certainly documented for maintainers, annotated with YARD tags, etc. but that is intended to be read with the source code, not in a separate website. Then, teams also have typically selected topics written down in Markdown files, or in a GitHub wiki... that kind of thing. If a team absolutely needs to generate application documentation for internal purposes, they can still easily write their own task. Regarding doc:rails and doc:guides, we live in 2015. We are used to go to online docs all the time. If you really want access to the API offline RubyGems generates it for every Rails component unless you tell it not to, and you can checkout the Rails source code to read the guides as Markdown, or download them for a Kindle reader. All in all, maintaining this code does not seem to be worthwhile anymore. As a consequence of this, guides (+3 MB uncompressed) won't be distributed with the rails gem anymore. Of course, guides and API are going to be still part of releases, since documentation is maintained alongside code and tests. Also, time permitting, this will allow us to experiment with novel ways to generate documentation in the Rails docs server, since right now we were constrained by being able to generate them in the user's environment.
Diffstat (limited to 'rails.gemspec')
-rw-r--r--rails.gemspec2
1 files changed, 1 insertions, 1 deletions
diff --git a/rails.gemspec b/rails.gemspec
index b3143e6fe1..1398169922 100644
--- a/rails.gemspec
+++ b/rails.gemspec
@@ -16,7 +16,7 @@ Gem::Specification.new do |s|
s.email = 'david@loudthinking.com'
s.homepage = 'http://www.rubyonrails.org'
- s.files = ['README.md'] + Dir['guides/**/*'] - Dir['guides/output/**/*']
+ s.files = ['README.md']
s.add_dependency 'activesupport', version
s.add_dependency 'actionpack', version