Add build-publish docs in CI/CD either as downstream pipeline or its own job #101
Description
Whenever we merge a branch into main, we need to retrigger publishing of documentation.
There is a standalone pipeline in the documentation repository which takes care of building and publishing documentation. A skaffold process has been setup where an image is built and deployed into a kubernetes cluster.
Simplest way to do this (i.e. publish docs on merge to main) is to simply trigger that pipeline from here once the merge is complete (i.e. pipeline completes in main branch). If this is possible, add publish stage where the downstream pipeline is triggered and return value/exit status is collected. It would even be better if the downstream pipeline can be directly controlled from here.
If not, copy the contents of downstream pipeline (or somehow integrate it as docs is a sub-repo). Introduce two stages - build and publish where there is a job in the build stage that builds the docker file of the documentation and the publish stage that completes the skaffold deploy. Secrets can be added when the MR is ready.