astonishing-london-2419
09/15/2021, 8:52 AMnox
to build our docs (a single docset for the whole monorepo), which basically implies starting a new virtualenv, installing sphinx and a couple of things and running sphinx-build
. This command needs to be able to load the libraries, as we have all sorts of autodocs features. I have been thinking on how to achieve that with pants and I guess I should create a new target that would be sphinx_docs
and it would have all the libraries as dependencies. However, it seems strange that this has never come up (I have searched slack to no avail) so I thought I’d ask first.adorable-engine-71736
09/15/2021, 2:57 PMhappy-kitchen-89482
09/15/2021, 3:38 PMadorable-engine-71736
09/15/2021, 3:54 PMastonishing-london-2419
09/15/2021, 5:54 PMsphinx-apidoc
automodule
and the likehappy-kitchen-89482
09/15/2021, 7:52 PMdocgen
goal on the existing python_library targets./pants docgen path/to/targets::
or whateversphinx_docs
target isadorable-engine-71736
09/15/2021, 8:02 PMsphinx_runner
that i currently use in bazel for the main envoy docsastonishing-london-2419
09/16/2021, 3:27 AMadorable-engine-71736
09/16/2021, 7:36 AMastonishing-london-2419
09/16/2021, 12:31 PMhappy-kitchen-89482
09/16/2021, 3:44 PMadorable-engine-71736
09/16/2021, 3:46 PMhappy-kitchen-89482
09/16/2021, 4:15 PM