more details in docs

Author: cparkinson

README.md

@@ -1,4 +1,21 @@
 # A11y-Add-on-for-FacetWP
+
 DevCollaborative's accessibility improvements for FacetWP Wordpress plugin
 
-Semantic checkboxes courtesy of Mark Root-Wiley, [MRW Web Design](https://mrwweb.com/) [Accessibility Addon for FacetWP](https://github.com/mrwweb/accessibility-addon-for-facetwp)
+## Description
+
+A11y Add-on for FacetWP adds accessibility enhancements for FacetWP's form elements.
+
+FacetWP must be installed and activated.
+
+- Wraps all facets in a div with class=facet-wrap
+- Adds a label to each facet with text=facet_label, for=facet_name
+- Adds an id to each facet with id=facet_name
+- FacetWP default checkbox markup replaced with semantic HTML checkboxes
+- Search field uses <search> landmark and real <button>
+- Always hides counts in dropdowns
+- Disables auto-refresh
+- Customizes icon for prev/next pagination links
+- Scroll back to top of results when pager is clicked
+
+Semantic HTML checkboxes courtesy of Mark Root-Wiley, [MRW Web Design](https://mrwweb.com/) [Accessibility Addon for FacetWP](https://github.com/mrwweb/accessibility-addon-for-facetwp)