Add uninstall command and modify relationship option in cli docs

This PR adds an uninstall command for `dab` to be handily available if developers need to clean and reinstall. 
Also adds a reminder to the `relationship` option that both source and target entities should already have been added.

Author: Aniruddh25

docs/getting-started/dab-cli.md

@@ -4,8 +4,6 @@ The Data API Builder CLI (**dab CLI** or `dab`) is a command line tool that stre
 
 - Find the source code here: [Cli](../../src/Cli)
 - Getting started: [Getting started](./getting-started-dab-cli.md)
-- Contribute: [Build from Source](../../src/Cli/CONTRIBUTING.md)
-
 ## Key Features of `dab` CLI
 
 - Initialize the configuration file for REST and GraphQL endpoints
@@ -19,5 +17,4 @@ The Data API Builder CLI (**dab CLI** or `dab`) is a command line tool that stre
 ## Contributing to the CLI
 
 Your feedback and contributions are key to its success.
-
 [Build from Source](../../CONTRIBUTING.md)

docs/getting-started/getting-started-dab-cli.md

@@ -71,14 +71,19 @@ dab add <entity> --source <source_db> --graphql <graphql_type> --permissions <ro
 To update entities which are already added to the config, run the following update command:
 
 ```dotnetcli
-# dab update book --permissions "authenticate:create" --fields.include "id,title"
+# dab update book --permissions "authenticate:create,update" --fields.include "id,title"
 
 dab update <entity> --source <new_source_db> --graphql <new_graphql_type> --permissions <rules:actions> --fields.include <fields_to_include> --fields.exclude <fields_to_exclude>
 ```
 
 ### Add entity relationship mappings
 
 To add relationship mappings between entities, use the following command:
+Make sure both the source and target entities have already been added.
+
+```dotnetcli
+# dab add author --source dbo.authors --permissions "anonymous:create,read,update"
+```
 
 ```dotnetcli
 # dab update author --relationship books --target.entity book --cardinality many --linking.object dbo.books_authors
@@ -91,7 +96,7 @@ dab update <entity> --relationship <relationship_name> --target.entity <target_e
 To add policy details, run the following command:
 
 ```dotnetcli
-# dab update book --permissions "anonymous:read" --fields.include "*" --policy-database "@claims.id eq @item.id"
+# dab update book --permissions "authenticated:update" --fields.include "*" --policy-database "@claims.id eq @item.id"
 
 dab update <entity> --permissions <roles> --fields.include <fields> --policy-database <policy_conditions>
 ```
@@ -110,3 +115,11 @@ To start the Data API Builder engine, use:
 > DAB loads the config in the following order (if not supplied in command-line arguments):
 > - `dab-config.{DAB_ENVIRONMENT}.json` : For example, the `dab-config.Development.json` and `dab-config.Production.json` files. The environment version of the file is loaded based on the value set for `DAB_ENVIRONMENT` environment variable.
 > - `dab-config.json`
+
+## Uninstall the tool
+
+For some reason, if you need to uninstall `dab` cli, simply do:
+
+```dotnetcli
+dotnet tool uninstall -g dab
+```

docs/readme.md

@@ -5,6 +5,5 @@
 - [Getting started](./getting-started/getting-started.md)
 - [Configuration file](./configuration.md)
 - [Command Line Interface](./getting-started/dab-cli.md)
-- [Running Data API builder for Azure Database](./engine.md)
-- [REST features](./rest.md)
+- [REST features](./REST.md)
 - [GraphQL features](./graphql.md)