Skip to content

Github workflows that can be shared across all HOT projects.

License

Notifications You must be signed in to change notification settings

hotosm/gh-workflows

Repository files navigation

HOT Github Workflows

HOT

Github workflows that can be shared across all HOT projects.

Version Build Docs Publish Docs License


📖 Documentation: https://hotosm.github.io/gh-workflows

🖥️ Source Code: https://github.com/hotosm/gh-workflows


Intro

⚙️ Intro to Workflows

This repo contains reusable workflows, that can be called from any other repo.

Motivations for creating this:

  • Reduce code duplication for workflows across our repos.
  • Easy version control and upgrading of our workflows over time.
  • Attempt to find the best possible implementation of the workflow, then standardise across repos.

To add new workflows

  • Add your .yml workflow to .github/workflows.
  • Create a .md file under docs, in the same format as the others.
    • The file should have empty content, with a title, and ## headers: Inputs, Outputs, Secrets.
  • Add to .github/workflows/workflow_docs.yml:
    • A step in the same format as others using tj-actions/auto-doc@v3, changing variables.
    • Add an entry under files in the Verify Changed Files step.
  • Add an entry to mkdocs.yml nav section.

To manually document workflows using auto-doc

Replace the .yml and .md file names below:

curl -LO https://github.com/tj-actions/auto-doc/releases/download/v3.1.0/auto-doc_3.1.0_Linux_x86_64.tar.gz

tar -xzsf auto-doc_3.1.0_Linux_x86_64.tar.gz

rm -rf auto-doc_3.1.0_Linux_x86_64.tar.gz

./auto-doc --filename .github/workflows/openapi_build.yml \
    --output docs/openapi_build.md --reusable

rm auto-doc