From 1066615328c11f7a3b05a22c3239e891c6ee8a42 Mon Sep 17 00:00:00 2001
From: John Joyce <john@acryl.io>
Date: Mon, 9 Jan 2023 11:24:17 -0800
Subject: [PATCH] fix(docs): Updating Tag, Glossary Term docs to point to
 correct GraphQL methods (#6965)

---
 .../src/main/resources/entity.graphql         |  4 ++--
 docs/glossary/business-glossary.md            | 21 +++++++++++++++++++
 docs/tags.md                                  | 14 +++++++++----
 3 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/datahub-graphql-core/src/main/resources/entity.graphql b/datahub-graphql-core/src/main/resources/entity.graphql
index faa38d223e..9a02ec44f3 100644
--- a/datahub-graphql-core/src/main/resources/entity.graphql
+++ b/datahub-graphql-core/src/main/resources/entity.graphql
@@ -1541,7 +1541,7 @@ type GlossaryTerm implements Entity {
     type: EntityType!
 
     """
-    Name / id of the glossary term
+    A unique identifier for the Glossary Term. Deprecated - Use properties.name field instead.
     """
     name: String! @deprecated
 
@@ -3571,7 +3571,7 @@ type Tag implements Entity {
     type: EntityType!
 
     """
-    The name / id of the tag. Use properties.name instead.
+    A unique identifier for the Tag. Deprecated - Use properties.name field instead.
     """
     name: String! @deprecated
 
diff --git a/docs/glossary/business-glossary.md b/docs/glossary/business-glossary.md
index 369ba98482..d320b42747 100644
--- a/docs/glossary/business-glossary.md
+++ b/docs/glossary/business-glossary.md
@@ -86,10 +86,31 @@ In the modal that pops up you can select the Term you care about in one of two w
 
 ![](../imgs/glossary/add-term-modal.png)
 
+## Managing Glossary with Git 
+
+In many cases, it may be preferable to manage the Business Glossary in a version-control system like git. This can make
+managing changes across teams easier, by funneling all changes through a change management and review process.
+
+To manage your glossary using Git, you can define it within a file and then use the DataHub CLI to ingest
+it into DataHub whenever a change is made (e.g. on a `git commit` hook). For detailed information about the format of
+the glossary file, and how to ingest it into DataHub, check out the [Business Glossary](../generated/ingestion/sources/business-glossary.md) source guide.
+
 ## Demo
 
 Check out [our demo site](https://demo.datahubproject.io/glossary) to see an example Glossary and how it works!
 
+### GraphQL
+
+* [addTerm](../../graphql/mutations.md#addterm)
+* [addTerms](../../graphql/mutations.md#addterms)
+* [batchAddTerms](../../graphql/mutations.md#batchaddterms)
+* [removeTerm](../../graphql/mutations.md#removeterm)
+* [batchRemoveTerms](../../graphql/mutations.md#batchremoveterms)
+* [createGlossaryTerm](../../graphql/mutations.md#createglossaryterm)
+* [createGlossaryNode](../../graphql/mutations.md#createglossarynode) (Term Group)
+
+You can easily fetch the Glossary Terms for an entity with a given its URN using the **glossaryTerms** property. Check out [Working with Metadata Entities](../api/graphql/querying-entities.md#querying-for-glossary-terms-of-an-asset) for an example.
+
 ## Resources
 - [Creating a Business Glossary and Putting it to use in DataHub](https://blog.datahubproject.io/creating-a-business-glossary-and-putting-it-to-use-in-datahub-43a088323c12)
 - [Tags and Terms: Two Powerful DataHub Features, Used in Two Different Scenarios](https://medium.com/datahub-project/tags-and-terms-two-powerful-datahub-features-used-in-two-different-scenarios-b5b4791e892e)
diff --git a/docs/tags.md b/docs/tags.md
index 0ab737aa0e..6a350769ec 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -72,10 +72,16 @@ You can search for a tag in the search bar, and even filter entities by the pres
 
 ### GraphQL
 
-* [Tag](../graphql/queries.md#tag)
-* [AddTagsInput](../graphql/inputObjects.md#addtagsinput)
-* [BatchAddTagsInput](../graphql/inputObjects.md#batchaddtagsinput)
-* [BatchRemoveTagsInput](../graphql/inputObjects.md#batchremovetagsinput)
+* [addTag](../graphql/mutations.md#addtag)
+* [addTags](../graphql/mutations.md#addtags)
+* [batchAddTags](../graphql/mutations.md#batchaddtags)
+* [removeTag](../graphql/mutations.md#removetag)
+* [batchRemoveTags](../graphql/mutations.md#batchremovetags)
+* [createTag](../graphql/mutations.md#createtag)
+* [updateTag](../graphql/mutations.md#updatetag)
+* [deleteTag](../graphql/mutations.md#deletetag)
+
+You can easily fetch the Tags for an entity with a given its URN using the **tags** property. Check out [Working with Metadata Entities](./api/graphql/querying-entities.md#querying-for-tags-of-an-asset) for an example. 
 
 ### DataHub Blog