Merge pull request #22 from fastenhealth/fasten_sources_embedded_json

using updated brands, portals and endpoints catalog

README.md

@@ -15,14 +15,31 @@
 [![GitHub Sponsors](https://img.shields.io/github/sponsors/analogj?style=flat-square)](https://github.com/sponsors/AnalogJ/)
 
 
-The Fasten Sources is a library that defines medical provider metadata (`definitions` - OpenID Metadata documents)
+The Fasten Sources is a library that contains medical provider metadata (`definitions` - OpenID Metadata documents)
 and http clients (OAuth2/Smart-on-FHIR clients) which can be used to retrieve data from various Medical
 Providers (`clients`).
 
+The source data is generated by the [fasten-sources-gen](https://www.github.com/fastenhealth/fasten-sources-gen) project, and then
+copied to the `catalog` folder of this project.
+
 
 > See [SOURCE_LIST.md](./SOURCE_LIST.md) for a full list of sources available in this repo. 
 
 
+# Usage
+
+## Search Engine
+
+Brands and Portals will be stored and indexed in Elasticsearch. The search engine will be used to find the correct Brand and associated Portals & Endpoints
+
+## Definitions
+
+Definitions are OpenID Metadata documents that are used to configure OAuth2 clients. These definitions contain Endpoint 
+information merged with Platform configuration
+
+
+
+
 # Types
 
 There are multiple protocols used by the Medical Provider industry to transfer patient data, the following mechanisms are the