compas-dev · gonzalocasas · Mar 17, 2026 · Mar 13, 2026 · Mar 13, 2026 · Mar 13, 2026
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -13,11 +13,18 @@ jobs:
     if: "!contains(github.event.pull_request.labels.*.name, 'docs-only')"
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        python: ['3.9', '3.10', '3.11']
+        os: [ubuntu-latest]
+        python: ["3.9", "3.12"]
+        include:
+          - os: macos-latest
+            python: "3.12"
+          - os: windows-latest
+            python: "3.12"
 
     steps:
+      - uses: actions/checkout@v4
       - uses: compas-dev/compas-actions.build@v4
         with:
           python: ${{ matrix.python }}

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -14,6 +14,8 @@ jobs:
   docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: compas-dev/compas-actions.docs@v4
+      - uses: compas-dev/compas-actions.docs@v5
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
+          generator: mkdocs
+          extras: dev,mkdocs
diff --git a/.github/workflows/pr-checks.yml b/.github/workflows/pr-checks.yml
@@ -11,7 +11,7 @@ jobs:
     name: Check Actions
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
       - name: Changelog check
         uses: Zomzog/changelog-checker@v1.2.0
         with:

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+* Added support for `Mkdocs` documentation generation, using `mkdocs.docs` task. (`Mkdocs` is an optional dependency at the moment, but may become a required dependency in the future).
+
 ### Changed
 
 ### Removed

diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-ETH Zurich
+Copyright (c) 2026 COMPAS Association
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

diff --git a/docs/_images/PLACEHOLDER b/docs/_images/PLACEHOLDER
diff --git a/docs/_logo/compas_logo_white_transparent.png b/docs/_logo/compas_logo_white_transparent.png
diff --git a/docs/_logo/favicon.ico b/docs/_logo/favicon.ico
diff --git a/docs/_static/PLACEHOLDER b/docs/_static/PLACEHOLDER
diff --git a/docs/api.rst b/docs/api.rst
diff --git a/docs/api/build.md b/docs/api/build.md
@@ -0,0 +1,3 @@
+# Build Tasks
+
+::: compas_invocations2.build
diff --git a/docs/api/console.md b/docs/api/console.md
@@ -0,0 +1,3 @@
+# Console Tasks
+
+::: compas_invocations2.console
diff --git a/docs/api/docs.md b/docs/api/docs.md
@@ -0,0 +1,3 @@
+# Documentation Tasks
+
+::: compas_invocations2.docs
diff --git a/docs/api/style.md b/docs/api/style.md
@@ -0,0 +1,3 @@
+# Style Tasks
+
+::: compas_invocations2.style
diff --git a/docs/api/tests.md b/docs/api/tests.md
@@ -0,0 +1,3 @@
+# Test Tasks
+
+::: compas_invocations2.tests
diff --git a/docs/assets/stylesheets/custom.css b/docs/assets/stylesheets/custom.css
@@ -0,0 +1,5 @@
+:root  > * {
+  --md-primary-fg-color:        #0092d2;
+  --md-primary-fg-color--light: #0092d2;
+  --md-primary-fg-color--dark:  #0092d2;
+}
diff --git a/docs/conf.py b/docs/conf.py
diff --git a/docs/examples/PLACEHOLDER b/docs/examples/PLACEHOLDER
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1,10 @@
+# COMPAS Invocations 2
+
+A collection of reusable [`pyinvoke`](https://pyinvoke.org/) tasks for COMPAS packages.
+
+## Features
+
+- **Project Management**: Tasks for releasing, cleaning, and managing changelogs.
+- **Documentation**: Tasks for building Sphinx and MkDocs documentation.
+- **Code Style**: Tasks for linting (ruff) and formatting (black/isort).
+- **Testing**: Tasks for running pytest and doctests.
diff --git a/docs/index.rst b/docs/index.rst
diff --git a/docs/installation.md b/docs/installation.md
@@ -0,0 +1,7 @@
+# Installation
+
+Install `compas_invocations2` using `pip` from the Python Package Index.
+
+```bash
+pip install compas_invocations2
+```
diff --git a/docs/installation.rst b/docs/installation.rst
diff --git a/docs/license.md b/docs/license.md
@@ -0,0 +1,3 @@
+# License
+
+--8<-- "LICENSE"
diff --git a/docs/license.rst b/docs/license.rst
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# Console Tasks

		::: compas_invocations2.console
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# Documentation Tasks

		::: compas_invocations2.docs