doc.yml

parameters:
  # What the primary language of this build is. Choices are GO | PYTHON | DOCKER.
  - name: language
    type: string

  # Whether to generate protobuff docs
  - name: docProtoc
    type: boolean

  # Whether to create static go API docs.
  - name: docGodoc
    type: boolean

steps:
  - ${{ if eq(parameters.language, 'GO') }}:
    - template: doc_setup_go.yml
      parameters:
        docGodoc: ${{ parameters.docGodoc }}

  - ${{ if eq(parameters.language, 'PYTHON') }}:
      - template: doc_setup_python.yml

  # Generate protoc docs. We do this after the Go docs so the go static documentation
  # does not overwrite our proto.html output
  - ${{ if parameters.docProtoc }}:
      - template: doc_generate_proto_static.yml

  # Build Documentation With Sphinx
  - script: python setup.py build_sphinx -E
    displayName: Build docs
    condition: succeeded()

  # Set up docs for github pages publishing.
  - template: doc_publish_github_pages.yml