doc_setup_go.yml

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

steps:
  # We need to install sphinx via python
  - template: doc_setup_python.yml

  - ${{ if parameters.docGodoc }}:
    # Build API documentation. We just need to build the source static html files here
    # and sphinx can use them.
    - script: |
        go install github.com/illuscio-dev/docmodule-go@latest
        go install golang.org/x/tools/cmd/godoc@latest
      displayName: Go get doc tools
      workingDirectory: $(Agent.BuildDirectory)

    - script: docmodule-go
      displayName: Generate static API docs