Design document for dashboards-as-code

[github-actions[bot]]

This PR breaks backwards compatibility for databrickslabs/ucx downstream. See build logs for more details.

_{Running from downstreams #50}

[github-actions[bot]]

❌ 20/21 passed, 1 failed, 2 skipped, 24m30s total

❌ test_load_dashboard: databricks.sdk.errors.platform.ResourceDoesNotExist: Path (/Workspace/Users/serge.smertin@databricks.com/Trivial Dashboard.lvdash.json) doesn't exist. (331ms)

``` databricks.sdk.errors.platform.ResourceDoesNotExist: Path (/Workspace/Users/serge.smertin@databricks.com/Trivial Dashboard.lvdash.json) doesn't exist. 13:13 DEBUG [databricks.sdk] Loaded from environment 13:13 DEBUG [databricks.sdk] Ignoring pat auth, because metadata-service is preferred 13:13 DEBUG [databricks.sdk] Ignoring basic auth, because metadata-service is preferred 13:13 DEBUG [databricks.sdk] Attempting to configure auth: metadata-service 13:13 INFO [databricks.sdk] Using Databricks Metadata Service authentication [gw6] linux -- Python 3.10.14 /home/runner/work/lsql/lsql/.venv/bin/python 13:13 DEBUG [databricks.sdk] Loaded from environment 13:13 DEBUG [databricks.sdk] Ignoring pat auth, because metadata-service is preferred 13:13 DEBUG [databricks.sdk] Ignoring basic auth, because metadata-service is preferred 13:13 DEBUG [databricks.sdk] Attempting to configure auth: metadata-service 13:13 INFO [databricks.sdk] Using Databricks Metadata Service authentication 13:13 DEBUG [databricks.sdk] GET /api/2.0/workspace/export?path=/Workspace/Users/serge.smertin@databricks.com/Trivial+Dashboard.lvdash.json&direct_download=true&format=SOURCE < 404 Not Found < { < "error_code": "RESOURCE_DOES_NOT_EXIST", < "message": "Path (/Workspace/Users/serge.smertin@databricks.com/Trivial Dashboard.lvdash.json) doesn't exist... (1 more bytes)" < } 13:13 DEBUG [databricks.sdk] Loaded from environment 13:13 DEBUG [databricks.sdk] Ignoring pat auth, because metadata-service is preferred 13:13 DEBUG [databricks.sdk] Ignoring basic auth, because metadata-service is preferred 13:13 DEBUG [databricks.sdk] Attempting to configure auth: metadata-service 13:13 INFO [databricks.sdk] Using Databricks Metadata Service authentication 13:13 DEBUG [databricks.sdk] GET /api/2.0/workspace/export?path=/Workspace/Users/serge.smertin@databricks.com/Trivial+Dashboard.lvdash.json&direct_download=true&format=SOURCE < 404 Not Found < { < "error_code": "RESOURCE_DOES_NOT_EXIST", < "message": "Path (/Workspace/Users/serge.smertin@databricks.com/Trivial Dashboard.lvdash.json) doesn't exist... (1 more bytes)" < } [gw6] linux -- Python 3.10.14 /home/runner/work/lsql/lsql/.venv/bin/python ```

_{Running from acceptance #80}