major documentation update

README.md

@@ -1,8 +1,8 @@
 # Flask Unchained
 
-## The quickest and easiest way to build large web apps and APIs with Flask and SQLAlchemy
+## The quickest and easiest way to build web apps and APIs with Flask
 
-**Flask Unchained is a Flask extension, a pluggable application factory, and a set of mostly optional "bundles" that together create a modern, fully integrated, and highly customizable web framework *for* Flask and its extension ecosystem.** Flask Unchained aims to stay true to the spirit and API of Flask, while making it significantly easier to quickly build large web apps and APIs with Flask and SQLAlchemy.
+**Flask Unchained is a Flask extension, a pluggable application factory, and a set of mostly optional "bundles" that together create a modern, fully integrated, and highly customizable web framework *for* Flask and its extension ecosystem.** Flask Unchained aims to stay true to the spirit and API of Flask, while making it significantly easier to quickly build web apps and APIs with Python.
 
 Flask Unchained introduces "bundles" to Flask: bundles are Python packages that integrate functionality with Flask, Flask Unchained, and other bundles. That could mean anything from integrating vanilla Flask extensions to being full-blown apps *your* app can integrate, customize, and extend (like say, a blog or web store). Unlike vanilla Flask extensions, bundles are both consistent and highly extensible and customizable. Once you figure out how something works in one bundle, it's the same in every other bundle. They are conceptually similar to Django's "apps", but I think you'll find bundles are even more powerful and flexible.
 

docs/bundles/admin.rst

@@ -10,16 +10,20 @@ Install dependencies:
 
 .. code:: bash
 
-   pip install "flask-unchained[admin]"
+   pip install "flask-unchained[sqlalchemy,session,security,admin]"
 
-Enable the bundle in your ``unchained_config.py``:
+Enable the bundle in your ``BUNDLES``:
 
 .. code:: python
 
    # project-root/unchained_config.py
 
    BUNDLES = [
        # ...
+       'flask_unchained.bundles.babel',       # required by Security Bundle
+       'flask_unchained.bundles.session',     # required by Security Bundle
+       'flask_unchained.bundles.sqlalchemy',  # required by Admin Bundle
+       'flask_unchained.bundles.security',    # required by Admin Bundle
        'flask_unchained.bundles.admin',
        'app',
    ]
@@ -31,8 +35,8 @@ And include the Admin Bundle's routes:
     # project-root/your_app_bundle/routes.py
 
     routes = lambda: [
-        include('flask_unchained.bundles.admin.routes'),
         # ...
+        include('flask_unchained.bundles.admin.routes'),
     ]
 
 Config

docs/bundles/api.rst

@@ -161,7 +161,7 @@ And that's it, unless you need to customize any behavior.
    * - serializer_create
      - The serializer instance to use for loading data for creation of a new model.
      - Determined automatically by the model name. Can be set manually to override the automatic discovery.
-   * - serializer_many
+   * - serializer_list
      - The serializer instance to use for (de)serializing a list of models.
      - Determined automatically by the model name. Can be set manually to override the automatic discovery.
    * - include_methods

docs/bundles/index.rst

@@ -10,8 +10,8 @@
 
 .. BEGIN document -------------------------------------------------------------
 
-Included Bundles
-================
+Bundles
+=======
 
 .. toctree::
     :maxdepth: 2

docs/conf.py

@@ -112,7 +112,7 @@
     'globaltoc_includehidden': False,
 
     'heroes': {
-        '*': 'The quickest and easiest way to build large web apps and APIs with Flask and SQLAlchemy',
+        '*': 'The quickest and easiest way to build web apps and APIs with Flask',
     },
     # disable tabs below the hero
     'master_doc': False,