Update README and add keywords to composer.json

Author: chrispenny

README.md

@@ -1,4 +1,4 @@
-# 🧭 Silverstripe Discoverer > Search Query module
+# 🧭 Silverstripe Discoverer > Search query module
 
 * [Purpose](#purpose)
 * [Delivery](#delivery)
@@ -10,26 +10,39 @@
 
 ## Purpose
 
-To provide you (a Silverstripe developer) with interfaces for search querying that **do not change**, even when you switch between
-different search service providers.
+To provide you (a Silverstripe developer) with interfaces for search querying that **do not change**, even when you
+switch between different search service providers (EG: Elastic, Algolia, Silverstripe Search).
 
 ## Delivery
 
 To deliver on our purpose, the way that you perform filtering, faceting, and certainly the way that you display
 results, is very likely going to change. We hope that the learning curve is reasonable, and that the majority of
 developer interactions with this code is intuative (once you understand the mentality behind it).
 
+You will **not** be able to perform any sort of "raw filtering" or "raw querying" with service specific formats, as that
+would not meet the purpose of this module - which is to use a common interface that will allow you to easily switch
+between services.
+
+## Installation
+
+```
+composer require "silverstripe/silverstripe-discoverer"
+```
+
+*Note* this module is not functional without an
+[integration module](#available-service-integration-modules)
+
 ## Feature support
 
 Whether or not certain features are supported **by this module**. Noting that different search providers often do things
-in very different ways, and often have different levels of support for features. This module attempts to provide a level
+in different ways, and often have different levels of support for features. This module attempts to provide a level
 of functionality that is commonly supported by many different services.
 
 | Feature                                                     | Module support | Future module support | Rationale                                                                                                                                                                                                                                   |
 |-------------------------------------------------------------|----------------|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Filters                                                     | Yes            | Yes                   | You should (hopefully) be able to achieve any sort of nested filtering that you require.                                                                                                                                                    |
 | Facets                                                      | Partial        | If desired            | Facet support differs hugely between search services. Current thinking is to try and limit what sort of Facet integrations we use (EG: no Geolocation) in the hopes that if we switch services in the future, we won't lose functionality   |
-| Multi-search                                                | No             | If desired            | Not supported by many other search services. It wouldn't be unreasonable effort to add this functionality though.                                                                                                                           |
+| Multi-search                                                | No             | If desired            | Not supported by many search services. It wouldn't be unreasonable effort to add this functionality though.                                                                                                                                 |
 | Search suggestions (aka auto-complete, "did you mean", etc) | Yes            | Yes                   | Features like auto-complete generate a lot of requests, and for a lower tiered shared service, that is something we want to cut down on.                                                                                                    |
 | Click through logging                                       | Yes            | Yes                   | Supported in Elastic App Search, but not supported by many other Search Services (including Elasticsearch). This feature in particular is an example of the "silent treatment" we apply when a feature disappears between service providers |
 
@@ -58,3 +71,8 @@ Additional documentation can also be found below:
 * [Detailed querying](docs/detailed-querying.md)
   * Lots more information about filters, facets, sorts, and (hopefully) everything else you need to know to perform
     whatever sort of search you require.
+
+## Available service integration modules
+
+* [Silverstripe Discoverer > Elastic Enterprise Search](https://github.com/silverstripeltd/silverstripe-discoverer-elastic-enterprise)
+* [Silverstripe Discoverer > Silverstripe Search](https://github.com/silverstripeltd/silverstripe-discoverer-bifrost)

composer.json

@@ -13,7 +13,12 @@
     "keywords": [
         "Silverstripe",
         "Silverstripe CMS",
-        "Search"
+        "Search",
+        "Searching",
+        "Filter",
+        "Filtering",
+        "Query",
+        "Querying"
     ],
     "require": {
         "php": "^8.1",