1452758 - Generate tc-worker docs in an installer-compatible fashion

Status: RESOLVED INVALID

(Taskcluster :: Services, enhancement)

Description

[Dustin J. Mitchell [:dustin] (he/him)]

https://github.com/taskcluster/taskcluster-worker/blob/78f17374b3813997f66b7c0e9ec1350524184260/.taskcluster.yml#L225-L251 does some partial generation of docs, but then relies on upload-project-docs from taskcluster-lib-docs for the rest.

The two "new" ways of building docs in taskcluster-installer are:
 - run the equivalent of upload-project-docs on the checked-out repo
 - invoke a simple 'write-docs' endpoint on the app to generate a compatible tarball

This doesn't really fit either mold.  Rather than replicate the .taskcluster.yml functionality (differently) in a special-case in taskcluster-installer, can we make taskcluster-worker use one of the two ways given above?

Probably the ideal would be to have taskcluster-installer build the tc-worker docker images, and then call `DOCS_OUTPUT_DIR=/foo docker run taskcluster-worker write-docs` similar to how it does for services.  Maybe that uses some taskcluster-lib-docs-go library, too?

https://github.com/taskcluster/taskcluster-worker/commit/78f17374b3813997f66b7c0e9ec1350524184260 temporarily gets things building again.

Comment 1

[Dustin J. Mitchell [:dustin] (he/him)]

We don't need this if we're not supporting tc-worker :D