mirror of https://github.com/databricks/cli.git
0b222358ca | ||
---|---|---|
.. | ||
docs | ||
README.md | ||
docs.go | ||
docs_test.go | ||
openapi.go | ||
openapi_test.go | ||
schema.go | ||
schema_test.go | ||
tracker.go |
README.md
Overview
docs/bundle_descriptions.json
contains both autogenerated as well as manually written
descriptions for the json schema. Specifically
resources
: almost all descriptions are autogenerated from the OpenAPI spectargets
: almost all descriptions are copied over from root level entities (eg:bundle
,artifacts
)bundle
: manually edittedinclude
: manually edittedworkspace
: manually edittedartifacts
: manually editted
These descriptions are rendered in the inline documentation in an IDE
SOP: Add schema descriptions for new fields in bundle config
Manually edit bundle_descriptions.json to add your descriptions. Note that the
descriptions in resources
block is generated from the OpenAPI spec, and thus
any changes there will be overwritten.