diff --git a/README.md b/README.md
index 9ffeb96..b667be4 100644
--- a/README.md
+++ b/README.md
@@ -1,56 +1,55 @@
-Module: Suggestion
-Author: bkelly bill@williamakelly.com
-
 CONTENTS OF THIS FILE
-====================
-  * Description
-  * Requirements
-  * Installation
-
+---------------------
 
-Description
-===========
-The suggestion module provides autocomplete suggestions for search fields.
+ * Introduction
+ * Requirements
+ * Installation
+ * Configuration
+ * Maintainers
 
-The suggestions are sourced 3 ways:
-  1. Content suggestions are parsed from node titles of selected content types.
 
-  2. Priority suggestions are added via the admin interface and take priority
-     over all other suggestions.
+INTRODUCTION
+------------
 
-  3. Surfer suggestions are added when a form is submitted. This organically
-     grows and prioritizes the suggestions.
+The Autocomplete Search Suggestions module provides autocomplete search
+suggestions. The module is compatible with standard Drupal search, search views
+and Apache SOLR, but not dependent on any of them.
 
-  * For a full description of the module, visit the project page:
-    https://drupal.org/project/suggestion
+ * For a full description of the module visit:
+   https://www.drupal.org/project/suggestion
 
-  * To submit bug reports and feature suggestions, or to track changes:
-    https://drupal.org/project/issues/suggestion
+ * To submit bug reports and feature suggestions, or to track changes visit:
+   https://www.drupal.org/project/issues/suggestion
 
 
-Requirements
-============
-  * Drupal 8.x
-  * Node
-  * Block
+REQUIREMENTS
+------------
 
+This module requires no modules outside of Drupal core.
 
-Installation
-============
-  1. Copy the 'suggestion' directory in to your Drupal modules directory.
 
-  2. Enable the module.
+INSTALLATION
+------------
 
-  3. Flush the cache.
+Install the Autocomplete Search Suggestions module as you would normally install
+a contributed Drupal module. Visit https://www.drupal.org/node/1897420 for
+further information.
 
-  4. Go to /admin/config/suggestion and configure the suggestion settings.
 
-  5. After configuration has been saved, index suggestions.
+CONFIGURATION
+-------------
 
-  6. Optionally, the Suggestion Search block can be enabled.
+    1. After the module is installed, enable the module.
+    2. Flush the site cache.
+    3. Go to Administration > Configuration > Suggestion and configure the
+       suggestion settings.
+       Note: there must be node content present before you can modify the
+       settings.
+    4. After configuration has been saved, index suggestions.
+    5. Optionally, the Suggestion Search block can be enabled.
 
 
 MAINTAINERS
-===========
-Current maintainers:
-  * Bill Kelly (bkelly) - https://drupal.org/user/265918
+-----------
+
+ * bkelly - https://www.drupal.org/u/bkelly