MONGOID-5645: Incorporate railsmdb README into Mongoid 9 docs (#5782)

* Add railsmdb to the Mongoid 9 release notes

* Updated release notes

* Updated installation instructions

* Update release notes

* Updated index

Author: alexbevi

source/index.txt

@@ -6,8 +6,9 @@ Mongoid
 
 .. default-domain:: mongodb
 
-Mongoid is the officially supported object-document mapper (ODM)
-for MongoDB in Ruby.
+Mongoid is the officially supported object-document mapper (ODM) for MongoDB in
+Ruby. To work with Mongoid from the command line using ``rails``-like tooling,
+the `railsmdb <https://github.com/mongodb/mongoid-railsmdb>`_ utility can be used.
 
 .. toctree::
   :titlesonly:

source/installation.txt

@@ -32,16 +32,33 @@ To install the gem with bundler, include the following in your ``Gemfile``:
 Using Mongoid with a New Rails Application
 ==========================================
 
-When creating a new Rails application and wish to use Mongoid for
-data access, give the ``--skip-active-record`` flag to the ``rails new``
-command to avoid depending on and configuring ActiveRecord..
+By using the `railsmdb CLI <https://github.com/mongodb/mongoid-railsmdb>`_ a new
+Ruby on Rails application can be quickly generated using the same options as
+``rails new``, but configured to work with MongoDB:
+
+.. code-block:: sh
+
+   railsmdb new my_new_rails_app
+
+The ``rails`` CLI can also be used, however when creating a new Rails application
+and where Mongoid will be used for data access, provide the ``--skip-active-record``
+flag to the ``rails new`` command to avoid depending on and configuring ActiveRecord.
+
+Additional examples can be found in the `tutorials <tutorials.html>`_.
 
 Using Mongoid with an Existing Rails Application
 ================================================
 
-When converting an existing Rails application to use Mongoid for data access,
-the ``config/application.rb`` file needs to be updated to remove the
-``require 'rails/all'`` line and explicitly include the required frameworks
-(which could be all of the frameworks provided by Rails with the exception of
-ActiveRecord). Any references to ActiveRecord in files in the ``config``
-directory and in the models also need to be removed.
+Using the `railsmdb CLI <https://github.com/mongodb/mongoid-railsmdb>`_ an existing
+Rails application can easily be configured for use with Mongoid:
+
+.. code-block:: sh
+
+   railsmdb setup
+
+Converting an existing Rails application without using ``railsmdb`` can be done
+by updating the ``config/application.rb`` file to remove the ``require 'rails/all'``
+line and explicitly include the required frameworks (which could be all of the
+frameworks provided by Rails with the exception ofActiveRecord).
+Any references to ActiveRecord in files in the ``config`` directory and in the
+models also need to be removed.

source/release-notes/mongoid-9.0.txt

@@ -17,6 +17,71 @@ The complete list of releases is available `on GitHub
 please consult GitHub releases for detailed release notes and JIRA for
 the complete list of issues fixed in each release, including bug fixes.
 
+Railsmdb for Mongoid
+--------------------
+
+To coincide with the release of Mongoid 9.0 a new command-line utility for creating,
+updating, managing, and maintaining Rails applications has also
+been made generally available!
+
+``railsmdb`` makes it easier to work with MongoDB from the command line through
+common generators that Ruby on Rails developers are already familiar with.
+
+For example, you can use ``railsmdb`` to generate stubs for new Mongoid models:
+
+.. code-block:: sh
+
+    $ bin/railsmdb generate model person
+
+This will create a new model at ``app/models/person.rb``:
+
+.. code-block:: ruby
+
+    class Person
+      include Mongoid::Document
+      include Mongoid::Timestamp
+    end
+
+You can specify the fields of the model as well:
+
+.. code-block:: ruby
+
+    # bin/railsmdb generate model person name:string birth:date
+
+    class Person
+      include Mongoid::Document
+      include Mongoid::Timestamp
+      field :name, type: String
+      field :birth, type: Date
+    end
+
+You can instruct the generator to make the new model a subclass of another,
+by passing the ``--parent`` option:
+
+.. code-block:: ruby
+
+    # bin/railsmdb generate model student --parent=person
+
+    class Student < Person
+      include Mongoid::Timestamp
+    end
+
+And if you need to store your models in a different collection than can be
+inferred from the model name, you can specify ``--collection``:
+
+.. code-block:: ruby
+
+    # bin/railsmdb generate model course --collection=classes
+
+    class Course
+      include Mongoid::Document
+      include Mongoid::Timestamp
+      store_in collection: 'classes'
+    end
+
+For more information see the `GitHub Repository <https://github.com/mongodb/mongoid-railsmdb>`_.
+
+
 Aggregable API is deprecated
 ----------------------------