techdocs-common has a dependency on @backstage/plugin-techdocs-backend. This prohibits techdocs-cli to import it and generate/publish docs on a CI/CD environment to an external storage
The creation of temporary directories and their clean up should be handled on its own. techdocs-cli already has a fixed input output dir requirement. It makes that generator accepts these values as requirements.
I initially thought the GCS Nodejs client would make use of it, since it asked for it in the contructor. However, we may not need them at all. Buckets are gloablly unique anyway.
GOOGLE_APPLICATION_CREDENTIALS is the environment variable used by the client. Compute Engine, Google Kubernetes Engine, App Engine, Cloud Run, and Cloud Functions automatically provide a default service account and set this env variable.
https://cloud.google.com/docs/authentication/production
TechDocs Generator uses a temporary directory to store the generated files. But with techdocs-cli, the generator needs to output in a fixed directory.
Also, make parsedLocationAnnotation optional since it is not a critical requirement for the generator.
* 'master' of github.com:backstage/backstage: (23 commits)
cli: fix windows tests
Introduce slight bias towards positive trend in cost insights mock data
core-api: rename BackstageRoutes to FlatRoutes
Update plugins/catalog/src/hooks/useEntity.ts
Fix parameter name in docstring for duration#inclusiveStartDateOf
Adjust test
Add changeset
fix: token expiration in s, not ms
Create loud-days-breathe.md
Create polite-glasses-occur.md
dev-utils: add a small label with the entity name to EntityGridItems
dev-utils: add EntityGridItem for easily displaying various entity cards
dev-utils: use dev index module as root for hot reloading
dev-utils: add .registerPage for use with extensions
catalog: rename EntityProvider to EntityLoaderProvider, and add new EntityProvider
reduce close timeout to 100 ms
changeset: add changeset for core-api RouteRef deprecations
core-api: use typescript workaround for using private constructor instead of a runtime one
core-api: deprecate RouteRef path and remove deprecated createSubRoute
delay window close by 200 ms
...
Himanshu Mishra