Documenting bear paragraph modules.

Author: jkaeser

docs/modules.md

@@ -1,4 +1,4 @@
-#Bear Included Contributed Modules
+# Bear Included Contributed Modules
 
 Bear includes helpful modules for site builders and developers with default settings that help start building Drupal sites faster.
 
@@ -14,3 +14,13 @@ Bear includes helpful modules for site builders and developers with default sett
 - pathauto
 - simple_sitemap
 - token
+
+# Bear Custom Modules
+
+Bear comes packaged with some custom modules that are designed to speed up the site building process. Like the rest of Bear, you are encouraged to modify these modules as you see fit.
+
+## Bear Paragraphs
+
+[Paragraphs](https://www.drupal.org/project/paragraphs) is a powerful module that is extremely useful in component based approaches to site development. Each Bear Paragraph module includes a preconfigured paragraph bundle and can be enabled via drush (e.g. `drush en bear_paragraph_text_area`) or through the Drupal UI.
+
+To keep them lean and unobtrusive, these paragraph bundles come completely un-styled. Each is completely self-contained and does does not depend on any module other than Paragraphs. More information about each module can be found in the module's `.info.yml` file.

modules/custom/bear_paragraph_banner/bear_paragraph_banner.info.yml

@@ -1,5 +1,5 @@
 name: Bear Paragraph Banner
-description: Provides a Banner paragraph type.
+description: Provides a Banner paragraph bundle composed of an image, a title, and a subtitle. This module includes a custom template that structures the rendered paragraph using HTML5 `<figure>` and `<figcaption>` elements.
 package: Bear
 
 type: module

modules/custom/bear_paragraph_collection/bear_paragraph_collection.info.yml

@@ -1,5 +1,5 @@
 name: Bear Paragraph Collection
-description: Provides a Collection paragraph type.
+description: Provides a Collection paragraph type, which acts as a container for other paragraphs. The content editor can choose to render the collection as a list or a grid with a selectable number of columns (2-8). Based on the selections, the module adds appropriate CSS classes for theming.
 package: Bear
 
 type: module

modules/custom/bear_paragraph_image/bear_paragraph_image.info.yml

@@ -1,5 +1,5 @@
 name: Bear Paragraph Image
-description: Provides an Image paragraph type.
+description: Provides an Image paragraph bundle with a single image field.
 package: Bear
 
 type: module

modules/custom/bear_paragraph_text_and_image/bear_paragraph_text_and_image.info.yml

@@ -1,5 +1,5 @@
 name: Bear Paragraph Text and Image
-description: Provides a Text and Image paragraph type.
+description: Provides a Text and Image paragraph type. Content editors can choose whether the image appears to the right or left of the text area. A custom template provides appropriate markup and classes for theming.
 package: Bear
 
 type: module

modules/custom/bear_paragraph_text_area/bear_paragraph_text_area.info.yml

@@ -1,5 +1,5 @@
 name: Bear Paragraph Text Area
-description: Provides a Text Area paragraph type.
+description: Provides a Text Area paragraph type with a single text area field.
 package: Bear
 
 type: module

modules/custom/bear_paragraph_two_column/bear_paragraph_two_column.info.yml

@@ -1,5 +1,5 @@
 name: Bear Paragraph Two Column
-description: Provides a two column paragraph type.
+description: Provides a two column paragraph type that, by default, has two paragraph reference fields – one for the left column and one for the right column. These columns appear next to each other in the node edit form.
 package: Bear
 
 type: module