Farmer Docs

About the Documentation Platform

Farmer's docs use Hugo and the hugo-theme-learn theme.

To build these docs locally

• Install Go language support and Hugo (if on Windows, we recommend using Chocolatey and running choco install golang hugo)
• The theme is in a sub-module, so you'll also want to run git submodule update --init
• Install the theme: cd themes/ and then git clone https://github.com/matcornic/hugo-theme-learn.git
• To build, run hugo from the root. To serve a local copy, run hugo server.

Publishing these Docs

These docs use GitHub Actions and the Actions-hugo tooling to publish the contents to GitHub pages

How it works:

• A change is committed to the docs branch (say, when a PR is merged).
• The GitHub Actions workflow begins.
• The action pulls the docs branch, runs hugo, and then publishes the "public" folder output to the gh-pages branch.
• The gh-pages branch is served by GitHub Pages at https://compositionalit.github.io/farmer.