Docs fixes week of 12 22

docs/cli.md

@@ -220,6 +220,9 @@ Telemetry is enabled by default, and the `telemetry` command lets you toggle the
 ### delete
 
 The `delete` command allows you to delete metadata from DataHub. Read this [guide](./how/delete-metadata.md) to understand how you can delete metadata from DataHub.
+:::info
+Deleting metadata using DataHub's CLI and GraphQL API is a simple, systems-level action. If you attempt to delete an Entity with children, such as a Container, it will not automatically delete the children, you will instead need to delete each child by URN in addition to deleting the parent. 
+:::
 
 ```console
 datahub delete --urn "urn:li:dataset:(urn:li:dataPlatform:hive,SampleHiveDataset,PROD)" --soft

docs/how/delete-metadata.md

@@ -10,6 +10,10 @@ Read on to find out how to perform these kinds of deletes.
 
 _Note: Deleting metadata should only be done with care. Always use `--dry-run` to understand what will be deleted before proceeding. Prefer soft-deletes (`--soft`) unless you really want to nuke metadata rows. Hard deletes will actually delete rows in the primary store and recovering them will require using backups of the primary metadata store. Make sure you understand the implications of issuing soft-deletes versus hard-deletes before proceeding._ 
 
+
+:::info
+Deleting metadata using DataHub's CLI and GraphQL API is a simple, systems-level action. If you attempt to delete an Entity with children, such as a Domain, it will not delete those children, you will instead need to delete each child by URN in addition to deleting the parent. 
+:::
 ## Delete By Urn
 
 To delete all the data related to a single entity, run

metadata-ingestion/docs/sources/business-glossary/datahub-business-glossary.md

@@ -38,7 +38,7 @@ The business glossary source file should be a `.yml` file with the following top
 - **custom_properties**: A map of key/value pairs of arbitrary custom properties
 - **domain**: (optional) domain name or domain urn
 
-You can also view an example business glossary file checked in [here](../../../examples/bootstrap_data/business_glossary.yml)
+You can also view an example business glossary file checked in [here](https://github.com/datahub-project/datahub/blob/master/metadata-ingestion/examples/bootstrap_data/business_glossary.yml)
 
 ## Compatibility