1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
rails--rails/railties/CHANGELOG.md
Xavier Noria cd7cc5254b 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.
2015-02-06 21:04:54 +01:00

2.2 KiB

  • Remove the documentation tasks doc:app, doc:rails, and doc:guides.

    Xavier Noria

  • Force generated routes to be inserted into routes.rb

    Andrew White

  • Don't remove all line endings from routes.rb when revoking scaffold.

    Fixes #15913.

    Andrew White

  • Rename --skip-test-unit option to --skip-test in app generator

    Melanie Gilman

  • Add the method_source gem to the default Gemfile for apps

    Sean Griffin

  • Drop old test locations from rake stats

    • test/functional
    • test/unit

    Ravil Bayramgalin

  • Update rake stats to correctly count declarative tests as methods in _test.rb files.

    Ravil Bayramgalin

  • Remove deprecated test:all and test:all:db tasks.

    Rafael Mendonça França

  • Remove deprecated Rails::Rack::LogTailer.

    Rafael Mendonça França

  • Remove deprecated RAILS_CACHE constant.

    Rafael Mendonça França

  • Remove deprecated serve_static_assets configuration.

    Rafael Mendonça França

  • Use local variables in _form.html.erb partial generated by scaffold.

    Andrew Kozlov

  • Add config/initializers/callback_terminator.rb

    Newly generated Rails apps have a new initializer called callback_terminator.rb which sets the value of the configuration option config.active_support.halt_callback_chains_on_return_false to false.

    As a result, new Rails apps do not halt callback chains when a callback returns false; only when they are explicitly halted with throw(:abort).

    The terminator is not added when running rake rails:update, so returning false will still work on old apps ported to Rails 5, displaying a deprecation warning to prompt users to update their code to the new syntax.

    claudiob

  • Generated fixtures won't use the id when generated with references attributes.

    Pablo Olmos de Aguilera Corradini

  • Add --skip-action-mailer option to the app generator.

    claudiob

  • Autoload any second level directories called app/*/concerns.

    Alex Robbin

Please check 4-2-stable for previous changes.