Merge pull request #825 from mandy-chessell/dev-dojo

Typos and improved explainations

site/docs/concepts/omag-server.md

@@ -27,6 +27,7 @@ Most APIs in Egeria require both a [platform URL root](#platform-url-root) and a
 
 ## Types of OMAG Server
 
+The function needed to operate the [open metadata ecosystem](/concepts/open-metadata-ecosystem) are organized into different types of [services](/services) that are configured in their own type of OMAG Server.  This makes it easier to explain how to set them up and connect them together.
 The types of OMAG Server are shown in Figure 1. The hierarchy groups similar types of server together.
 
 ![Figure 1](types-of-omag-servers.svg)
@@ -38,24 +39,34 @@ The types of OMAG Server are shown in Figure 1. The hierarchy groups similar typ
 
     Object-oriented software engineers would know of this type of relationship as behavior inheritance.
 
-- [Cohort member](cohort-member) - able to exchange metadata through an open metadata repository cohort
-    - [Metadata access store](/concepts/metadata-access-store) - supports a metadata repository that can natively store open metadata types as well as specialized metadata APIs for different types of tools (these APIs are called [access services](/services/omas)).
-    - [Metadata access point](/concepts/metadata-access-point) - supports the access services like the metadata server but does not have a repository. All metadata it serves up and stores belongs to the metadata repositories in other members of the cohort.
+- [Cohort member](cohort-member) - All of these types of servers are optionally able to exchange metadata through an open metadata repository cohort.  This is a peer-to-peer metadata exchange for metadata repositories.
+    - [Metadata access store](/concepts/metadata-access-store) - supports a metadata repository that can natively store open metadata along with specialized metadata APIs for different types of tools (these APIs are called [Open Metadata Access Services (OMASs)](/services/omas)).
+    - [Metadata access point](/concepts/metadata-access-point) - supports the OMASs like the metadata access store, but but does not have its own repository. All the metadata it serves up and stores belongs to the metadata repositories in other members of the cohort.  This type of server needs to be connected to at least one cohort to be useful.
     - [Repository proxy](/concepts/repository-proxy) - acts as an open metadata translator for a third party metadata repository. It supports open metadata API calls and translates them to the proprietary APIs of the repository. It also translates events from the proprietary repository into open metadata events that flow over the cohort.
     - [Conformance test server](/concepts/conformance-test-server) - validates that a member of the cohort is conforming with the open metadata protocols. This server is typically only seen in development and test cohorts rather than production.
 - [View server](/concepts/view-server) - manages specialist services for user interfaces.
 - [Governance server](/concepts/governance-server) - supports the use of metadata in the broader IT landscape.
-    - [Engine host](/concepts/engine-host) - provides a runtime for a specific type of [governance engine](/services/omes).
-    - [Integration daemon](/concepts/integration-daemon) - manages the synchronization with third party technology that can not call the access services directly through the [integration services](/services/omis).
+    - [Engine host](/concepts/engine-host) - provides a runtime for a specific type of [governance engine](/concepts/governance-engine) that runs [governance services](/concepts/governance-service) to monitor, enhance and govern the open metadata ecosystem.
+    - [Integration daemon](/concepts/integration-daemon) - manages the synchronization of metadata with third party technology that can not call the access services directly.   through the [integration services](/services/omis).
     - [Data engine proxy](/concepts/data-engine-proxy) - supports the capture of metadata from a data engine. This includes details of the processing of data that it is doing which is valuable when piecing together lineage.
-    - [Open lineage server](/concepts/open-lineage-server) - Manages the collation of lineage information am maintains it in a format for reporting. This includes the state of the lineage at different points in time.
+    - [Open lineage server](/concepts/open-lineage-server) - Manages the collation of lineage information and maintains it in a format for reporting. This includes the state of the lineage at different points in time.
+
+## Server connectivity
+
+The different types of OMAG Servers connect together as illustrated in Figure 2.  Metadata Access Stores and Metadata Access Points (collectively called [Metadata Access Servers](/concepts/metadata-access-server)) provide access to open metadata to the governance servers and view servers via their [Open Metadata Access Services (OMASs)](/services/omas).
+The Governance Servers connect to external tools, engines and platforms.  The View Servers are called by user interfaces (including Egeria's user interfaces).
+Multiple Metadata Access Servers can share metadata with Repository Proxies via one or more cohorts.   
 
-## Inter-connectivity
 
-The different types of OMAG Servers connect together as illustrated in Figure 2. There is an inner ring of cohort members communicating via the cohort. Each cohort member is sharing the metadata they receive with the governance servers and view servers that connect to it. The governance servers connect out to external tools, engines and platforms.
 
 ![Figure 2](omag-server-ecosystem.svg)
-> **Figure 2:** The inter-connectivity between OMAG Servers
+> **Figure 2:** The connectivity between OMAG Servers
+
+The repository for a Metadata Access Store may be connected to a conformance test server via a cohort to test that its implementation is conformant with the open metadata standards.  It is shown in figure 3.  This only happens during test and evaluation.
+
+![Figure 3](omag-server-ecosystem-cts.svg)
+> **Figure 3:** Conformance testing
+
 
 
 !!! education "Further information"

site/docs/concepts/open-metadata-ecosystem.md

@@ -0,0 +1,26 @@
+---
+hide:
+- toc
+---
+
+<!-- SPDX-License-Identifier: CC-BY-4.0 -->
+<!-- Copyright Contributors to the Egeria project. -->
+
+# The open metadata ecosystem
+
+The *open metadata ecosystem* is the collection of deployed technology that is connected and exchanging metadata in the open metadata formats defined by Egeria.  This ecosystem includes the Egeria technology such as the [OMAG Server Platform](/concepts/omag_server_platform) plus other technologies that have adopted the standards and frameworks defined by Egeria.
+
+The picture below is an illustration of an open metadata ecosystem.  The green clouds represent the different data centres and processing locations used by the organization.  They may be cloud services or on premises.
+
+At each processing location there typically at least one [OMAG Server Platform (blue boxes)](/concepts/omag_server_platform) deployed that hosts [OMAG Servers](/concepts/omag_server) (orange circles) that provide the synchronization services tailored to specific types of tools (grey boxes).  The OMAG Servers themselves host [connectors](/concepts/connector) that each interface with a particular third party technology.   Egeria's [frameworks](/frameworks) define the interfaces of the connectors and how they plug into the OMAG Servers.
+
+![Distributed operation](/introduction/egeria-distributed-operation.svg)
+
+
+!!! education "Further information"
+
+    - [Overview of Egeria](/introduction/overview)
+    - [Open Metadata Frameworks](/frameworks)
+    - [Open metadata types](/types)
+
+--8<-- "snippets/abbr.md"