chore: improve SEO verification and update tooling

Author: jgeluk

.python-version

@@ -0,0 +1,2 @@
+3.14.2
+

Makefile

@@ -23,15 +23,14 @@ endif
 endif
 
 #
-# Since we do not have asdf for Windows, we need to install these tools
-# on windows in a different way. Here we assume you did that yourself in
-# the local project's virtualenv directory (./.venv).
+# Windows note: install the required build tools separately (outside of this Makefile),
+# then run `make install` to create/use the local project's virtualenv (./.venv).
 #
 VENV_PYTHON := $(VIRTUAL_ENV)/bin/python3
 UV := uv
-PYTHON_VERSION := 3.13
+PYTHON_VERSION := 3.14.2
 
-PIPENV_DEFAULT_PYTHON_VERSION := 3.13
+PIPENV_DEFAULT_PYTHON_VERSION := 3.14.2
 PIPENV_VENV_IN_PROJECT := 1
 
 CURRENT_BRANCH := $(shell git branch --show-current)

README.md

@@ -2,6 +2,14 @@
 
 Documenting the Use Case Tree method.
 
+## Python
+
+This repo uses **Python 3.13+** (see `pyproject.toml`) and **uv**.
+
+```bash
+uv sync
+```
+
 This is an initiative of:
 
 - [agnos.ai UK Ltd](https://agnos.ai)

docs-overrides/partials/seo.html

@@ -8,7 +8,8 @@
 {% set full_title = page_title + " - " + config.site_name if page_title != config.site_name else config.site_name %}
 
 {# Get page URL #}
-{% set page_url = config.site_url + page.url if page.url else config.site_url %}
+{# Prefer MkDocs' canonical_url when available #}
+{% set page_url = page.canonical_url if page.canonical_url else (config.site_url + page.url if page.url else config.site_url) %}
 
 {# Get page image (use site logo or custom image) #}
 {% set page_image = config.site_url + "/assets/images/favicon.png" %}
@@ -46,6 +47,11 @@
 <meta name="keywords" content="{{ page.meta.keywords | join(', ') }}">
 {% endif %}
 
+{# Google Search Console verification #}
+{% if config.extra.google_site_verification %}
+<meta name="google-site-verification" content="{{ config.extra.google_site_verification }}">
+{% endif %}
+
 {# JSON-LD Structured Data #}
 <script type="application/ld+json">
 {

docs/concept/use-case.md

@@ -81,6 +81,7 @@ business outcomes within the Use Case Tree_
 
 === "Data & Tech Audience"
 
+    <span id="data-tech-audience"></span>
     ## What Is a Use Case in the Use Case Tree Method?
 
     A **Use Case** in the Use Case Tree Method specifies a distinct set of
@@ -358,6 +359,7 @@ business outcomes within the Use Case Tree_
 
 === "Plan/Build/Run"
 
+    <span id="plan-build-run"></span>
     ## Use Cases Across the Use Case Tree Method Process
 
     The Use Case Tree Method defines a process consisting of three phases, each
@@ -532,7 +534,7 @@ business outcomes within the Use Case Tree_
 
     ### UML Use Cases
 
-    As discussed in the [Data & Tech Audience](#data--tech-audience)
+    As discussed in the [Data & Tech Audience](#data-tech-audience)
     tab, Use Cases in the Use Case Tree Method share terminology with UML Use
     Cases but operate at a different level of abstraction.
 

docs/process/plan/ekg-method.code-workspace

@@ -17,6 +17,9 @@
 		},
 		{
 			"path": "../../../../benchmark"
+		},
+		{
+			"path": "../../../../agnos-website"
 		}
 	],
 	"settings": {

mkdocs.yml

@@ -58,6 +58,7 @@ theme:
 extra:
   homepage: https://www.ekgf.org/quadrants
   generator: false
+  google_site_verification: "Q_9d2He8XxoBrVAXrAXsEm2R_UrGZ6KcOCXkeNRQ058"
   social:
     - icon: fontawesome/brands/twitter
       link: https://twitter.com/EKG_Foundation

pyproject.toml

@@ -5,7 +5,7 @@ description = ""
 authors = [
   {name = "Jacobus Geluk", email = "jacobus.geluk@ekgf.org"},
 ]
-requires-python = ">=3.13"
+requires-python = ">=3.14.2"
 readme = "README.md"
 license = { file = "LICENSE" }
 dependencies = [