diff --git a/docs-website/sidebars.js b/docs-website/sidebars.js
index 8f463ff876e76..be534947e3e50 100644
--- a/docs-website/sidebars.js
+++ b/docs-website/sidebars.js
@@ -445,7 +445,6 @@ module.exports = {
// className: "saasOnly",
// },
// "docs/wip/ui-ingestion-guide", -- not needed
- // "docs/wip/tags-guide", -- not needed
// "docs/wip/personal-access-tokens-guide", -- not needed
{
diff --git a/docs/tags.md b/docs/tags.md
index 380418f58d27f..9b06331b125c4 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -1,52 +1,105 @@
-# Tags Guide
+import FeatureAvailability from '@site/src/components/FeatureAvailability';
-## What is a Tag?
+# About DataHub Tags
+
+ +
+ +Type in the name of the tag you want to add. You can add a new tag, or add a tag that already exists (the autocomplete will pull up the tag if it already exists). + ++ +
Click on the "Add" button and you'll see the tag has been added! -![](./imgs/added-tag.png) ++ +
If you would like to add a tag at the schema level, hover over the "Tags" column for a schema until the "Add Tag" button shows up, and then follow the same flow as above. -![](./imgs/added-tag.png) ++ +
-## Removing a Tag +### Removing a Tag To remove a tag, simply click on the "X" button in the tag. Then click "Yes" when prompted to confirm tag removal. +### Searching by a Tag + +You can search for a tag in the search bar, and even filter entities by the presence of a specific tag. + ++ +
+ +## Additional Resources + +### Videos + +**Add Ownership, Tags, Terms, and more to DataHub via CSV!** + ++ +
+ +### GraphQL + +* [Tag](../graphql/queries.md#tag) +* [AddTagsInput](../graphql/inputObjects.md#addtagsinput) +* [BatchAddTagsInput](../graphql/inputObjects.md#batchaddtagsinput) +* [BatchRemoveTagsInput](../graphql/inputObjects.md#batchremovetagsinput) + +### DataHub Blog + +* [Tags and Terms: Two Powerful DataHub Features, Used in Two Different Scenarios +Managing PII in DataHub: A Practitioner’s Guide](https://blog.datahubproject.io/tags-and-terms-two-powerful-datahub-features-used-in-two-different-scenarios-b5b4791e892e) + +## FAQ and Troubleshooting + +**What is the difference between DataHub Tags and Glossary Terms?** + +DataHub Tags are informal, loosely controlled labels while Terms are part of a controlled vocabulary, with optional hierarchy. Tags have no element of formal, central management. + +Usage and applications: -## Searching by Tag +* An asset may have multiple tags. +* Tags serve as a tool for search & discovery while Terms are typically used to standardize types of leaf-level attributes (i.e. schema fields) for governance. E.g. (EMAIL_PLAINTEXT) -You can search for a tag in the search bar, and if you wish, even filter entities by the presence of a specific tag. +**How are DataHub Tags different from Domains?** -![](./imgs/search-tag.png) +Domains are a set of top-level categories usually aligned to business units/disciplines to which the assets are most relevant. They rely on central or distributed management. A single domain is assigned per data asset. +*Need more help? Join the conversation in [Slack](http://slack.datahubproject.io)!* -## Feedback / Questions / Concerns +### Related Features -We want to hear from you! For any inquiries, including Feedback, Questions, or Concerns, reach out on Slack! \ No newline at end of file +* [Glossary Terms](./docs/how/business-glossary-guide.md) +* [Domains](./docs/domains.md) \ No newline at end of file diff --git a/docs/wip/tags-guide.md b/docs/wip/tags-guide.md deleted file mode 100644 index 83b78767910ed..0000000000000 --- a/docs/wip/tags-guide.md +++ /dev/null @@ -1,7 +0,0 @@ -import FeatureAvailability from '@site/src/components/FeatureAvailability'; - -# Tags Guide - -