chore(ci): tasks

Signed-off-by: Carlos A Becker <caarlos0@gmail.com>

.github/workflows/docs.yml

@@ -16,10 +16,12 @@ jobs:
       -
         name: checkout
         uses: actions/checkout@v2
+      -
+        name: Set up Task
+        uses: arduino/setup-task@v1
       -
         name: build
-        run: |
-          docker run --rm -v ${PWD}/www:/docs squidfunk/mkdocs-material build
+        run: task docs:build
       -
         name: htmltest
         uses: wjdp/htmltest-action@master

.github/workflows/generate.yml

@@ -23,8 +23,11 @@ jobs:
         with:
           go-version: 1.17
       -
-        name: docs
-        run: ./scripts/cmd_docs.sh
+        name: Set up Task
+        uses: arduino/setup-task@v1
+      -
+        name: Refresh docs
+        run: task docs:generate
       - uses: stefanzweifel/git-auto-commit-action@v4
         with:
           commit_message: "docs: update cmd docs"

.gitignore

@@ -14,3 +14,4 @@ www/site
 .idea/
 testdata/acceptance/tmp/
 completions/
+.task/

Taskfile.yml

@@ -83,6 +83,18 @@ tasks:
     cmds:
       - task: ci
 
+  docs:generate:
+    desc: Generate docs
+    cmds:
+      - ./scripts/cmd_docs.sh
+    sources:
+      - cmd/*.go
+      - ./scripts/cmd_docs.sh
+      - CONTRIBUTING.md
+    generates:
+      - www/docs/cmd/*.md
+      - www/docs/contributing.md
+
   docs:imgs:
     desc: Download and resize images
     cmds:
@@ -95,8 +107,15 @@ tasks:
   docs:serve:
     desc: Start documentation server
     cmds:
+      - task: docs:generate
       - '{{.DOCKER}} run --rm -it -p 8000:8000 -v ${PWD}/www:/docs docker.io/squidfunk/mkdocs-material'
 
+  docs:build:
+    desc: Build docs
+    cmds:
+      - task: docs:generate
+      - '{{.DOCKER}} run --rm -v ${PWD}/www:/docs docker.io/squidfunk/mkdocs-material build'
+
   docs:vercel:build:
     desc: Build documentation for deploying to Vercel
     cmds: