Edit pass over the railties CHANGELOG

Author: fxn

railties/CHANGELOG.md

@@ -1,14 +1,6 @@
-*   Ensure only directories exist in Rails default load paths
-
-    Previously, some files put under `app` directory would contaminate the load paths.
-    This commit removes files from the default load paths set up by the Rails framework.
-
-    Now, only directories are included as default in the following paths:
-
-    * autoload_paths
-    * autoload_once_paths
-    * eager_load_paths
-    * load_paths
+*   Ensure `autoload_paths`, `autoload_once_paths`, `eager_load_paths`, and
+    `load_paths` only have directories when initialized from engine defaults.
+    Previously, files under the `app` directory could end up there too.
 
     *Takumasa Ochi*
 
@@ -20,59 +12,59 @@
 
     *Takumasa Ochi*
 
-*   Use `oven-sh/setup-bun` in GitHub CI when generating an app with bun
+*   Use `oven-sh/setup-bun` in GitHub CI when generating an app with Bun.
 
     *TangRufus*
 
-*   Disable `pidfile` generation in production environment.
+*   Disable `pidfile` generation in the `production` environment.
 
     *Hans Schnedlitz*
 
-*   Set `config.action_view.annotate_rendered_view_with_filenames` to `true` in the
-    development environment.
+*   Set `config.action_view.annotate_rendered_view_with_filenames` to `true` in
+    the `development` environment.
 
     *Adrian Marin*
 
-*   Support `BACKTRACE` ENV variable to turn off backtrace cleaning.
+*   Support the `BACKTRACE` environment variable to turn off backtrace cleaning.
 
     Useful for debugging framework code:
 
     ```sh
-    BACKTRACE=1 ./bin/rails server
+    BACKTRACE=1 bin/rails server
     ```
 
     *Alex Ghiculescu*
 
-*   Raise `ArgumentError` when reading `config.x.something` with arguments
+*   Raise `ArgumentError` when reading `config.x.something` with arguments:
 
     ```ruby
     config.x.this_works.this_raises true # raises ArgumentError
     ```
 
     *Sean Doyle*
 
-*   Add default PWA files for manifest and service-worker that are served from `app/views/pwa` and can be dynamically rendered through erb. Mount these files explicitly at the root with default routes in the generated routes file.
+*   Add default PWA files for manifest and service-worker that are served from `app/views/pwa` and can be dynamically rendered through ERB. Mount these files explicitly at the root with default routes in the generated routes file.
 
     *DHH*
 
 *   Updated system tests to now use headless Chrome by default for the new applications.
 
     *DHH*
 
-*   Add GitHub CI files for dependabot, brakeman, rubocop, and running tests by default. Can be skipped with --skip-ci.
+*   Add GitHub CI files for Dependabot, Brakeman, RuboCop, and running tests by default. Can be skipped with `--skip-ci`.
 
     *DHH*
 
-*   Add brakeman gem by default for static analysis of security vulnerabilities. Allow skipping with --skip-brakeman option.
+*   Add Brakeman by default for static analysis of security vulnerabilities. Allow skipping with `--skip-brakeman option`.
 
     *vipulnsward*
 
-*   Add RuboCop with rules from rubocop-rails-omakase by default. Skip with --skip-rubocop.
+*   Add RuboCop with rules from `rubocop-rails-omakase` by default. Skip with `--skip-rubocop`.
 
     *DHH* and *zzak*
 
-*   Use `bin/rails runner --skip-executor` option to not wrap the runner script
-    with an Executor.
+*   Use `bin/rails runner --skip-executor` to not wrap the runner script with an
+    Executor.
 
     *Ben Sheldon*
 
@@ -82,7 +74,7 @@
 
     *Chedli Bourguiba*
 
-*   Fix running `db:system:change` when app has no Dockerfile.
+*   Fix running `db:system:change` when the app has no Dockerfile.
 
     *Hartley McGuire*
 
@@ -101,7 +93,7 @@
 
     *Christian Schmidt*
 
-*   Enable YJIT by default on new applications running Ruby 3.3+
+*   Enable YJIT by default on new applications running Ruby 3.3+.
 
     Adds a `config/initializers/enable_yjit.rb` initializer that enables YJIT
     when running on Ruby 3.3+.
@@ -119,7 +111,7 @@
 *   Use numeric UID and GID in Dockerfile template
 
     The Dockerfile generated by `rails new` sets the default user and group
-    by name instead of UID:GID. This can cause the following error in kubernetes:
+    by name instead of UID:GID. This can cause the following error in Kubernetes:
 
     ```
     container has runAsNonRoot and image has non-numeric user (rails), cannot verify user is non-root
@@ -131,13 +123,12 @@
 
 *   Disallow invalid values for rails new options.
 
-    The `--database`, `--asset-pipeline`, `--css`, and `--javascript` flags for
-    `rails new` can all take different options. This change adds checks to
-    options to make sure the user enters the correct value.
+    The `--database`, `--asset-pipeline`, `--css`, and `--javascript` options
+    for `rails new` take different arguments. This change validates them.
 
     *Tony Drake*, *Akhil G Krishnan*, *Petrik de Heus*
 
-*   Conditionally print `$stdout` when invoking `run_generator`
+*   Conditionally print `$stdout` when invoking `run_generator`.
 
     In an effort to improve the developer experience when debugging
     generator tests, we add the ability to conditionally print `$stdout`