googleapis / sphinx-docfx-yaml

Forked sphinx-docfx-yaml repository for creating DocFX YAML for Python Client Libraries
Apache License 2.0
5 stars 7 forks source link

build: update generate-docs to support monorepo #289

Closed dandhlee closed 1 year ago

dandhlee commented 1 year ago

Adds support for generating documentation for google-cloud-python repository. For corresponding packages already in the pipeline, crawls and regenerates documentation as required for those in the monorepo.

In case additional support is required for monorepo, instead of tweaking the existing code slightly I've added another section to handle monorepo portion separately. This is also likely required for extracting previous release tags within the monorepo, which will be much more complicated to handle. For now, I'll focus on supporting latest releases for the monorepo.

I've verified locally that the script works as expected - reproduced 6 packages found in the current pipeline for 6 Cloud packages found in https://github.com/googleapis/google-cloud-python/tree/main/packages. Checked that the script works with Kokoro test run.

Fixes #288. Towards b/249115548.