Latest doc updates (#715)

Move mention of the exercise script into the getting-started docs for Azure SQL DB.

Co-authored-by: Sean Leonard <[email protected]>
Co-authored-by: Aniruddh Munde <[email protected]>

Author: 3 people

README.md

@@ -29,9 +29,9 @@ With Data API builder, database objects can be exposed via REST or GraphQL endpo
 
 ## Limitations 
 
-- JWT only supports AAD
-- Tables must have a primary key. The primary key must be built on a single column.
-- MySQL, MariaDB and PostgreSQL are not yet fully supported.
+- JWT only supports Azure AD
+- Tables must have a primary key
+- MySQL, MariaDB and PostgreSQL are not yet fully supported
 
 ## Known Issues
 

docs/getting-started/getting-started-azure-sql-db.md

@@ -299,12 +299,14 @@ that will return all the books written by Isaac Asimov.
 
 Congratulations, you have just created a fully working backend to support your modern applications!
 
-## Deploy on Azure
-
-
-
-## Conclusion
-
-WIP
+## Exercise
 
+If you want to practice what you have learned, here's a little exercise you can do on your own
 
+- Using the database setup script `/samples/getting-started/azure-sql-db/exercise/exercise.library.azure-sql.sql`:
+  - add the table `dbo.series` which will store series names (for example: [Foundation Series](https://en.wikipedia.org/wiki/Foundation_series))
+  - update the `dbo.books` table by adding a column named `series_id`
+  - update the `dbo.books` table by adding a foreign key constraint on the `dbo.series` table
+- Update the configuration file with a new entity named `series`, supported by the `dbo.series` source table you just created.
+- Update the `book` entity by creating a relationship with the `series` entity. Make sure you select `one` for the `cardinality` property
+- Update the `series` entity by creating a relationship with the `book` entity. Make sure you select `many` for the `cardinality` property

docs/getting-started/getting-started.md

@@ -117,14 +117,6 @@ You can use Docker to run the Data API Builder on your machine. Instructions are
 
 Instead of creating the configuration file manually, you can take advantage of the CLI [Getting started with Data API Builder (`dab`) CLI](../getting-started/getting-started-dab-cli.md): 
 
-### Exercise
+### Deploy on Azure
 
-If you want to practice what you have learned, here's a little exercise you can do on your own
-
-- Use the code `/samples/getting-started/azure-sql-db/exercise/exercise.library.azure-sql.sql` to 
-  - add the `dbo.series` table where to store series names (for example: [Foundation Series](https://en.wikipedia.org/wiki/Foundation_series))
-  - update the `dbo.books` table to add the `series_id` column
-  - update the `dbo.books` table to add a foreign key constraint to the `dbo.series` table
-- Update the configuration file to add the `series` entity, supported by the `dbo.series` source table
-- Update the `book` entity to create a relationship with the `series` entity. Make sure you select `one` for the `cardinality` property
-- Update the `series` entity to create a relationship with the `book` entity. Make sure you select `many` for the `cardinality` property
+** Work in progress **

docs/readme.md

@@ -15,7 +15,7 @@ With Data API builder, database objects can be exposed via REST or GraphQL endpo
   - [Running using the CLI tool](./running-using-dab-cli.md)
 - [REST features](./rest.md)
 - [GraphQL features](./graphql.md)
-- [Authentication](./authentication.md) - **Work in progress**
-- [Authorization](./authorization.md) - **Work in progress**
-- [Relationships](./relationships.md) - **Work in progress**
-- [Known Issues and Limitations](/docs/known-issues.md) - **Work in progress**
+- [Authentication](./authentication.md) - **Documentation Work in progress**
+- [Authorization](./authorization.md) - **Documentation Work in progress**
+- [Relationships](./relationships.md) - **Documentation Work in progress**
+- [Known Issues and Limitations](/docs/known-issues.md) - **Documentation Work in progress**