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

Fix formatting and overuse of abbr.md
odpi · Apr 27, 2023 · 95280e2 · 95280e2
2 parents 1f920bf + 50ed841
commit 95280e2
Show file tree

Hide file tree

Showing 134 changed files with 71 additions and 157 deletions.
diff --git a/site/docs/concepts/audit-log-intro.md b/site/docs/concepts/audit-log-intro.md
@@ -30,6 +30,3 @@ The structure is defined by the Audit Log Framework (ALF).  The Open Metadata Re
 | 14            | `PerfMon`     | This log record contains performance monitoring timing information for specific types of processing. It is not normally logged to any destination, but can be added when needed.                                                    |
 | 0             | `<Unknown>`   | Uninitialized Severity                                                                                                                                                                                                              |
 
-
-
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/discovery/discovery-service-intro.md b/site/docs/connectors/discovery/discovery-service-intro.md
@@ -24,5 +24,3 @@ An open discovery service is designed to run at regular intervals to gather a de
 
     ![Open Discovery Service](/connectors/discovery/discovery-service.svg)
 
-
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/governance-action/governance-action-service-intro.md b/site/docs/connectors/governance-action/governance-action-service-intro.md
@@ -74,4 +74,3 @@ The interfaces for governance action services is defined in the [governance-acti
 
     Since the watchdog governance action service calls the provisioning governance action process explicitly via the governance action, their implementations are somewhat tied together.  The alternative is that the watchdog governance action service can invoke a [governance action process](/concepts/governance-action-process) that will choreograph the execution of one or more governance services based on a flow definition managed in open metadata.  The governance action process separates the implementation of the watchdog governance action service from the follow-on governance actions since changes to the follow-on processing is maintained through open metadata rather than requiring code changes to the watchdog governance action service code.
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/governance-daemon/governance-daemon-intro.md b/site/docs/connectors/governance-daemon/governance-daemon-intro.md
@@ -3,4 +3,3 @@
 
 The governance daemon connectors contain specialist connectors for the governance servers that make active use of open metadata.
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/integration/integration-connector-intro.md b/site/docs/connectors/integration/integration-connector-intro.md
@@ -10,4 +10,3 @@ An integration connector runs in an [Open Metadata Integration Service (OMIS)](/
 > An integration connector is shown deployed in an integration service running in an integration daemon.  The connector is linking to a third party technology and also calling the open metadata APIs of Egeria to manage the exchange of metadata.
 
 
----8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/repository-governance/repository-governance-service-intro.md b/site/docs/connectors/repository-governance/repository-governance-service-intro.md
@@ -12,4 +12,3 @@ A repository governance service can:
 - Issue requests to find and retrieve metadata instances from any of the repositories connected via Open Metadata Repository Cohorts.
 - Incrementally build and store an open metadata archive.
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/repository/event-mapper-connector-intro.md b/site/docs/connectors/repository/event-mapper-connector-intro.md
@@ -10,4 +10,3 @@ The *event mapper connector* provides a mechanism to translate events that signi
 Event mappers are needed in a [repository proxy](/concepts/repository-proxy) server if the third party technology that it is integrating into the [open metadata repository cohort](/concepts/cohort-member) also has its own mechanisms for maintaining metadata.  If the third party metadata repository's contents are static, or only updated through Egeria's mechanisms then no event mapper is needed.  If no event mapper is present, then the repository proxy ignores [refresh event requests](/features/cohort-operation/overview) from other members of the connected cohorts.  This means its metadata is only available through federated queries.
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/repository/repository-connector-intro.md b/site/docs/connectors/repository/repository-connector-intro.md
@@ -12,6 +12,5 @@ In the second pattern, called the *adapter repository connector*, the repository
 >  Repository connector and optional event mapper connector supporting an adapter to a third party metadata repository
 
 
---8<-- "snippets/abbr.md"
 
 
diff --git a/site/docs/connectors/resource/open-metadata-topic-connector-intro.md b/site/docs/connectors/resource/open-metadata-topic-connector-intro.md
@@ -14,4 +14,3 @@ The Open Metadata Topic Connector implements the [OpenMetadataTopicConnector](ht
     ![Open Metadata Topic Connector](/connectors/resource/open-metadata-topic-connector-in-egeria.svg)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/runtime/audit-log-destination-connector-intro.md b/site/docs/connectors/runtime/audit-log-destination-connector-intro.md
@@ -8,6 +8,3 @@ An *[audit log destination connector](/concepts/audit-log-destination-connector)
 
 An audit log destination's purpose may be either to store, process or distribute audit log records to diagnostic systems.  Its associated configuration controls which severities of audit log record it receives.  The implementation for the audit log destination connector can make further choices about how each log record is processed.
 
-
-
----8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/runtime/cohort-member-client-connector-intro.md b/site/docs/connectors/runtime/cohort-member-client-connector-intro.md
@@ -5,7 +5,6 @@ Members of an [Open Metadata Repository Cohort](/concepts/cohort-member) provide
 
 ![Cohort Member Client Connector](/connectors/runtime/cohort-member-client-connector.svg)
 
----8<-- "snippets/abbr.md"
 
 
 
diff --git a/site/docs/connectors/runtime/cohort-registry-store-connector-intro.md b/site/docs/connectors/runtime/cohort-registry-store-connector-intro.md
@@ -12,4 +12,3 @@ Inside the cohort registry store there is one local registration record describi
 
 A *[cohort registry store connector](/concepts/cohort-registry-store-connector)* manages the persistence of the cohort registry store.  Egeria uses a connector to allow different storage methods for different deployment environments.  Each member may choose their own implementation of the cohort registry store connector.
 
----8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/runtime/configuration-document-store-connector-intro.md b/site/docs/connectors/runtime/configuration-document-store-connector-intro.md
@@ -7,4 +7,3 @@ The configuration store connectors contain the connector implementations that ma
 
 There is one configuration document store connector defined for each [OMAG Server Platform](/concepts/omag-server-platform).
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/runtime/open-metadata-archive-store-connector-intro.md b/site/docs/connectors/runtime/open-metadata-archive-store-connector-intro.md
@@ -6,4 +6,3 @@ The *open archive store connector* manages the storage of an [Open Metadata Arch
 
 ![Open Metadata Archive Store Connector](/connectors/runtime/open-metadata-archive-store-connector.svg)
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/runtime/platform-metadata-security-connector-intro.md b/site/docs/connectors/runtime/platform-metadata-security-connector-intro.md
@@ -6,4 +6,3 @@ There is one platform metadata security connector defined for each OMAG Server P
 
 ![Platform Metadata Security Connector](/connectors/runtime/platform-metadata-security-connector.svg)
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/runtime/rest-client-connector-intro.md b/site/docs/connectors/runtime/rest-client-connector-intro.md
@@ -8,5 +8,4 @@ the REST API calls.
 
 ![REST Client Connector](/connectors/runtime/rest-client-connector.svg)
 
----8<-- "snippets/abbr.md"
 
diff --git a/site/docs/connectors/runtime/server-metadata-security-connector-intro.md b/site/docs/connectors/runtime/server-metadata-security-connector-intro.md
@@ -21,4 +21,3 @@ This connector is called each time a request is made to the server.  It is calle
     * [Writing a server metadata security connector](/guides/developer/runtime-connectors/server-metadata-security-connector)
     * [Configuring the server metadata security connector](/guides/admin/servers/configuring-the-server-security-connector) in a server.
 
----8<-- "snippets/abbr.md"
diff --git a/site/docs/connectors/secrets/secrets-store-connector-intro.md b/site/docs/connectors/secrets/secrets-store-connector-intro.md
@@ -26,4 +26,3 @@ The picture below shows a practical example of using the secrets store connector
 
 This pattern can also be used in the [Engine Host](/concepts/engine-host) with [Open Discovery Services](/concepts/open-discovery-service) and [governance action services](/concepts/governance-action-service).
 
----8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/developer/create-template-repository.md b/site/docs/education/egeria-dojo/developer/create-template-repository.md
@@ -48,7 +48,6 @@ ls
 
 It should be the same as the contents of the git repository on GitHub.
 
---8<-- "snippets/abbr.md"
 
 
 

diff --git a/site/docs/education/egeria-dojo/developer/develop-asset-listen-cut-paste.md b/site/docs/education/egeria-dojo/developer/develop-asset-listen-cut-paste.md
@@ -27,7 +27,6 @@
 ??? beginner "Resolve Egeria dependencies in AssetListen"
     ---8<-- "docs/education/tutorials/intellij-tutorial/intellij-resolve-external-dependencies.md"
 
---8<-- "snippets/abbr.md"
 
 
 

diff --git a/site/docs/education/egeria-dojo/developer/develop-asset-listen-template.md b/site/docs/education/egeria-dojo/developer/develop-asset-listen-template.md
@@ -10,7 +10,6 @@ Open up the **asset-listen** folder. You will see under the `resources` director
 ![Template repository projects](asset-listen-files.png)
 
 
---8<-- "snippets/abbr.md"
 
 
 

diff --git a/.../docs/education/egeria-dojo/developer/egeria-platform-report-mds1-configured.md b/.../docs/education/egeria-dojo/developer/egeria-platform-report-mds1-configured.md
@@ -169,4 +169,3 @@
 * **Location**: egeria.omag.server.mds1.omas.assetowner.inTopic
 * **Configuration Properties**: {producer={bootstrap.servers=localhost:9092}, local.server.id=fab57cdc-e7fb-4f23-8237-376c9fda492b, consumer={bootstrap.servers=localhost:9092, auto.commit.interval.ms=1}}
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/developer/egeria-platform-report-mds1-running.md b/site/docs/education/egeria-dojo/developer/egeria-platform-report-mds1-running.md
@@ -187,4 +187,3 @@
 * **Location**: egeria.omag.server.mds1.omas.assetowner.inTopic
 * **Configuration Properties**: {producer={bootstrap.servers=localhost:9092}, local.server.id=e6afd331-1853-42d0-a816-bb1eeb30c7b8, consumer={bootstrap.servers=localhost:9092, auto.commit.interval.ms=1}}
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/automating-metadata-capture.md b/site/docs/education/egeria-dojo/metadata-governance/automating-metadata-capture.md
@@ -21,4 +21,3 @@ People are not good at repetitive admin tasks, particularly if these tasks are n
         * [Validating your integration](/guides/integration/validating-your-integration)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/common-definitions.md b/site/docs/education/egeria-dojo/metadata-governance/common-definitions.md
@@ -33,5 +33,3 @@ The effort required to author and maintain a these standards, plus the governanc
 ??? education "Coco Pharmaceuticals Scenarios"
     There are descriptions of creating glossaries and other materials for subject areas in the [Coco Pharmaceuticals Scenarios](/practices/coco-pharmaceuticals/scenarios/overview).
 
-
---8<-- "snippets/abbr.md"
diff --git a/...ducation/egeria-dojo/metadata-governance/designing-your-governance-processes.md b/...ducation/egeria-dojo/metadata-governance/designing-your-governance-processes.md
@@ -13,4 +13,3 @@
     - [Governance Action Services](/guides/developer/governance-action-services/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/governance-by-expection.md b/site/docs/education/egeria-dojo/metadata-governance/governance-by-expection.md
@@ -12,4 +12,3 @@
     - [Setting up your Governance Program](/guides/planning/governance-program/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/governance-definitions.md b/site/docs/education/egeria-dojo/metadata-governance/governance-definitions.md
@@ -13,4 +13,3 @@
     - [Setting up your Governance Program](/guides/planning/governance-program/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/governance-zones.md b/site/docs/education/egeria-dojo/metadata-governance/governance-zones.md
@@ -13,4 +13,3 @@
     - [Governance Zoning](/features/governance-zoning/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/incident-management.md b/site/docs/education/egeria-dojo/metadata-governance/incident-management.md
@@ -13,4 +13,3 @@
     - [Incident reporting](/guides/planning/incident-reporting/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/integration-with-devops.md b/site/docs/education/egeria-dojo/metadata-governance/integration-with-devops.md
@@ -12,4 +12,3 @@
     - [DevOps OMAS](/services/omas/dev-ops/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/.../docs/education/egeria-dojo/metadata-governance/lineage-preservation-and-use.md b/.../docs/education/egeria-dojo/metadata-governance/lineage-preservation-and-use.md
@@ -14,4 +14,3 @@
 !!! education "Further information"
     - [Lineage Management](/features/lineage-management/overview)
 
---8<-- "snippets/abbr.md"
diff --git a/...docs/education/egeria-dojo/metadata-governance/linking-to-governance-program.md b/...docs/education/egeria-dojo/metadata-governance/linking-to-governance-program.md
@@ -36,4 +36,3 @@ Your organization will have other governance initiatives covering different aspe
 !!! education "Further information"
     - [Setting up your Governance Program](/guides/planning/governance-program/overview)
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/managing-reference-data.md b/site/docs/education/egeria-dojo/metadata-governance/managing-reference-data.md
@@ -15,4 +15,3 @@
     - [Reference Data Management](/features/reference-data-management/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/.../docs/education/egeria-dojo/metadata-governance/metadata-security-connectors.md b/.../docs/education/egeria-dojo/metadata-governance/metadata-security-connectors.md
@@ -13,4 +13,3 @@
     - [Metadata Security Connectors](/features/metadata-security/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/...ucation/egeria-dojo/metadata-governance/monitoring-your-governance-processes.md b/...ucation/egeria-dojo/metadata-governance/monitoring-your-governance-processes.md
@@ -12,4 +12,3 @@
     - [Open Lineage log store](/features/lineage-management/overview/#openlineage-log-store)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/open-metadata-types.md b/site/docs/education/egeria-dojo/metadata-governance/open-metadata-types.md
@@ -31,7 +31,7 @@
         | 6 - Metadata Discovery                     | Data Content Analysis Results                                                     |
         | 7 - Lineage                                | Business Context, Process Metadata                                                |
         
---8<-- "snippets/abbr.md"
+
 
 
 

diff --git a/site/docs/education/egeria-dojo/metadata-governance/securing-your-metadata.md b/site/docs/education/egeria-dojo/metadata-governance/securing-your-metadata.md
@@ -25,4 +25,3 @@ Metadata provides a window into your organization's resources and operations.  I
     - [Planning for security](/guides/planning/security/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/setting-up-engine-host.md b/site/docs/education/egeria-dojo/metadata-governance/setting-up-engine-host.md
@@ -11,4 +11,3 @@
 !!! education "Further information"
     - [Configuring the Engine Host](/guides/admin/servers/configuring-an-engine-host)
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/stewardship.md b/site/docs/education/egeria-dojo/metadata-governance/stewardship.md
@@ -12,4 +12,3 @@
     - [People, roles and organizations](/features/people-roles-organizations/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/user-directory.md b/site/docs/education/egeria-dojo/metadata-governance/user-directory.md
@@ -6,4 +6,3 @@
 - Supporting users and groups
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/users-people-orgs.md b/site/docs/education/egeria-dojo/metadata-governance/users-people-orgs.md
@@ -13,4 +13,3 @@
     - [People, roles and organizations](/features/people-roles-organizations/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/...education/egeria-dojo/metadata-governance/using-automated-governance-actions.md b/...education/egeria-dojo/metadata-governance/using-automated-governance-actions.md
@@ -28,4 +28,3 @@ The open metadata ecosystem collects, links and disseminates metadata from many
     * [Synchronizing Security Information](/features/synchronized-access-control/overview)
     * [Reference Data Management](/features/reference-data-management/overview)
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/using-metadata-discovery.md b/site/docs/education/egeria-dojo/metadata-governance/using-metadata-discovery.md
@@ -13,4 +13,3 @@
     - [Metadata discovery and stewardship](/features/discovery-and-stewardship/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/.../docs/education/egeria-dojo/metadata-governance/using-open-metadata-archives.md b/.../docs/education/egeria-dojo/metadata-governance/using-open-metadata-archives.md
@@ -14,4 +14,3 @@
     - [Governance Zoning](/features/metadata-archiving/overview)
 
 
---8<-- "snippets/abbr.md"
diff --git a/site/docs/education/egeria-dojo/metadata-governance/working-with-templates.md b/site/docs/education/egeria-dojo/metadata-governance/working-with-templates.md
@@ -10,8 +10,6 @@
 
 
 
---8<-- "snippets/abbr.md"
-
 
 
 

diff --git a/...ocs/education/tutorials/building-egeria-tutorial/task-building-egeria-source.md b/...ocs/education/tutorials/building-egeria-tutorial/task-building-egeria-source.md
@@ -78,4 +78,4 @@ The build scripts that use these technologies ensure the software is built in th
 
 --8<-- "docs/education/tutorials/building-egeria-tutorial/task-building-with-maven.md"
 
---8<-- "snippets/abbr.md"
+
diff --git a/.../docs/education/tutorials/building-egeria-tutorial/task-building-with-gradle.md b/.../docs/education/tutorials/building-egeria-tutorial/task-building-with-gradle.md
@@ -40,4 +40,4 @@ BUILD SUCCESSFUL in 10s
 3 actionable tasks: 1 executed, 2 up-to-date
 ```
 
---8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/building-egeria-tutorial/task-building-with-maven.md b/site/docs/education/tutorials/building-egeria-tutorial/task-building-with-maven.md
@@ -46,4 +46,4 @@ The build can take 15 minutes to over an hour depending on the repository and on
 Process finished with exit code 0
 ```
 
---8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/building-egeria-tutorial/task-installing-egeria.md b/site/docs/education/tutorials/building-egeria-tutorial/task-installing-egeria.md
@@ -7,4 +7,4 @@ Change to the top level `egeria` directory where your local copy of `egeria.git`
 
 --8<-- "docs/education/tutorials/building-egeria-tutorial/terminal-installing-egeria.md"
 
---8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/building-egeria-tutorial/task-installing-java.md b/site/docs/education/tutorials/building-egeria-tutorial/task-installing-java.md
@@ -20,5 +20,5 @@ Java can be installed by:
 
 Alternatively you may wish to install from your package manager such as `homebrew` on MacOS.
 
---8<-- "snippets/abbr.md"
+
 
diff --git a/site/docs/education/tutorials/building-egeria-tutorial/task-installing-maven.md b/site/docs/education/tutorials/building-egeria-tutorial/task-installing-maven.md
@@ -40,5 +40,5 @@ Maven can be installed by downloading the software from the Apache maven website
     On Windows, you should use [Windows Subsystem for Linux :material-dock-window:](https://docs.microsoft.com/en-us/windows/wsl/){ target=ms } Version 2 or above, install an appropriate Linux distribution, and follow the instructions for that Linux distribution.
 
 
---8<-- "snippets/abbr.md"
+
 
diff --git a/...docs/education/tutorials/git-and-git-hub-tutorial/task-adding-changes-to-git.md b/...docs/education/tutorials/git-and-git-hub-tutorial/task-adding-changes-to-git.md
@@ -38,4 +38,4 @@ Changes to be committed:
 
 Now you are ready to commit your contribution to your clone.
 
----8<-- "snippets/abbr.md"
+
diff --git a/.../education/tutorials/git-and-git-hub-tutorial/task-creating-a-fork-and-clone.md b/.../education/tutorials/git-and-git-hub-tutorial/task-creating-a-fork-and-clone.md
@@ -65,4 +65,4 @@ Now you are ready to [create a branch for your changes](/education/tutorials/git
     * Further details on the [fork](https://guides.github.com/activities/forking/) command.
 
 
----8<-- "snippets/abbr.md"
+
diff --git a/...ucation/tutorials/git-and-git-hub-tutorial/task-creating-an-issue-on-git-hub.md b/...ucation/tutorials/git-and-git-hub-tutorial/task-creating-an-issue-on-git-hub.md
@@ -40,4 +40,3 @@ Make a note of this issue number because you will need it later.
 
 Now you are ready to work on your contribution.
 
----8<-- "snippets/abbr.md"
diff --git a/...docs/education/tutorials/git-and-git-hub-tutorial/task-creating-git-branches.md b/...docs/education/tutorials/git-and-git-hub-tutorial/task-creating-git-branches.md
@@ -58,4 +58,4 @@ upstream https://github.com/odpi/egeria.git (push)
 
 Now you can make your changes to the content.  
 
----8<-- "snippets/abbr.md"
+
diff --git a/.../education/tutorials/git-and-git-hub-tutorial/task-downloading-egeria-source.md b/.../education/tutorials/git-and-git-hub-tutorial/task-downloading-egeria-source.md
@@ -103,4 +103,4 @@ ls
 
 It should be the same as the contents of the git repository on GitHub.
 
----8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/git-and-git-hub-tutorial/task-getting-git-hub-id.md b/site/docs/education/tutorials/git-and-git-hub-tutorial/task-getting-git-hub-id.md
@@ -13,4 +13,4 @@ Select the `Sign up` option.
 
 Once you have created your account then sign in.
 
----8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/git-and-git-hub-tutorial/task-git-pull-push-pr.md b/site/docs/education/tutorials/git-and-git-hub-tutorial/task-git-pull-push-pr.md
@@ -53,4 +53,4 @@ $ git push -d origin example-branch
 You may need to use `-D` if not all changes are merged, but check carefully!
 
 
----8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/git-and-git-hub-tutorial/task-installing-git.md b/site/docs/education/tutorials/git-and-git-hub-tutorial/task-installing-git.md
@@ -15,4 +15,3 @@ Git can be installed:
 - On Linux operating systems, by using your distribution's package manager (`yum install git`, `apt-get install git`, etc).
 - On Windows, you should use [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/) Version 2 or above, install an appropriate Linux distribution, and follow the instructions for Linux.
 
----8<-- "snippets/abbr.md"
diff --git a/.../docs/education/tutorials/intellij-tutorial/task-building-egeria-in-intellij.md b/.../docs/education/tutorials/intellij-tutorial/task-building-egeria-in-intellij.md
@@ -25,4 +25,4 @@ However, IntelliJ does not understand the egeria structure - only Maven
 does, so the Maven build is important to to verify your changes are
 OK at the project level.
 
----8<-- "snippets/abbr.md"
+
diff --git a/...cs/education/tutorials/intellij-tutorial/task-creating-content-with-intellij.md b/...cs/education/tutorials/intellij-tutorial/task-creating-content-with-intellij.md
@@ -23,4 +23,4 @@ Any changes, additions and deletions that you make to the files under the git re
 ![Git->Add option](intellij-git-add-option.png) 
 
 
----8<-- "snippets/abbr.md"
+
diff --git a/...cs/education/tutorials/intellij-tutorial/task-installing-egeria-via-intellij.md b/...cs/education/tutorials/intellij-tutorial/task-installing-egeria-via-intellij.md
@@ -8,4 +8,4 @@ If your development work is using the main Egeria libraries rather than developi
 --8<-- "docs/education/tutorials/intellij-tutorial/intellij-open-terminal.md"
 --8<-- "docs/education/tutorials/building-egeria-tutorial/terminal-installing-egeria.md"
 
---8<-- "snippets/abbr.md"
+
diff --git a/site/docs/education/tutorials/intellij-tutorial/task-installing-intellij.md b/site/docs/education/tutorials/intellij-tutorial/task-installing-intellij.md
@@ -25,4 +25,4 @@ Start up IntelliJ.
 ??? tip "Check your lombok setup"
     ---8<-- "docs/education/tutorials/intellij-tutorial/intellij-lombok-plugin.md"
 
----8<-- "snippets/abbr.md"
+