Draft: Issue #3052574: Facets with AJAX not working in most of situations

Closes #3052574

README.md

-CONTENTS OF THIS FILE
----------------------
+## CONTENTS OF THIS FILE
 
- * Requirements
- * Recommended Modules
- * Installation
- * Configuration
- * Features
- * Extension modules
- * FAQ
- * Maintainers
+  - Requirements
+  - Recommended Modules
+  - Installation
+  - Configuration
+  - Features
+  - Extension modules
+  - FAQ
+  - Maintainers
 
 
-INTRODUCTION
-------------
+## INTRODUCTION
 
 The Facets module allows site builders to easily create and manage faceted
 search interfaces.
 
 
-REQUIREMENTS
-------------
+## REQUIREMENTS
 
 No other modules required; we're supporting Drupal Core's search as a source for
 creating facets.
 
 
-RECOMMENDED MODULES
--------------------
+## RECOMMENDED MODULES
 
- * Search API - https://www.drupal.org/project/search_api
+  - Search API - https://www.drupal.org/project/search_api
 
 
-INSTALLATION
-------------
+## INSTALLATION
 
  * Install as you would normally install a contributed Drupal module. Visit:
-   https://www.drupal.org/node/1897420 for further information.
+   https://www.drupal.org/docs/extending-drupal/installing-modules for further information.
 
 
-CONFIGURATION
--------------
+## CONFIGURATION
 
 Before adding a facet, there should be a facet source. Facet sources can be:
 - Drupal core's search.
@@ -55,8 +49,7 @@ If you're using Search API views, make sure to disable views cache when using
 facets for that view.
 
 
-KNOWN ISSUES
-------------
+## KNOWN ISSUES
 
 When choosing the "Hard limit" option on a search_api_db backend, be aware that
 the limitation is done internally after sorting on the number of results ("num")
@@ -76,8 +69,7 @@ case the raw facet value with the lower value is preferred:
 further details see: https://www.drupal.org/node/2834730
 
 
-FEATURES
---------
+## FEATURES
 
 If you are the developer of a search API backend implementation and want
 to support facets with your service class, too, you'll have to support the
@@ -142,8 +134,7 @@ A filter is a string with one of the following forms:
   facet).
 
 
-EXTENSION MODULES
------------------
+## EXTENSION MODULES
 
 - https://www.drupal.org/project/entity_reference_facet_link
   Provides a link to a facet through an entity reference field.
@@ -160,8 +151,7 @@ EXTENSION MODULES
 - https://www.drupal.org/project/facets_range_dropdowns
   Provides an dropdown widget that works with the range processor.
 
-FAQ
----
+## FAQ
 
 Q: Why do the facets disappear after a refresh?
 A: We don't support cached views, change the view to disable caching.
@@ -195,8 +185,7 @@ This should only happen if you're not using the default node access framework
 provided by Core, though. You need to use a combination of hook_node_grants and
 hook_node_access_records instead of hook_node_access.
 
-MAINTAINERS
------------
+## MAINTAINERS
 
  * Joris Vercammen (borisson_) - https://www.drupal.org/u/borisson_
  * Jimmy Henderickx (StryKaizer) - https://www.drupal.org/u/strykaizer