diff --git a/.github/workflows/markdownlint.yaml b/.github/workflows/markdownlint.yaml
index a7c79ee..a4d1386 100644
--- a/.github/workflows/markdownlint.yaml
+++ b/.github/workflows/markdownlint.yaml
@@ -5,7 +5,7 @@ on:
 
 jobs:
   mdl:
-    runs-on: [self-hosted, edge]
+    runs-on: [self-hosted-linux-amd64-noble-edge]
     steps:
       - name: Check out code
         uses: actions/checkout@v6
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 78269e2..b3e0ba0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -20,8 +20,9 @@
 - [Test Structure](#test-structure)
 - [Type Hints](#type-hints)
 
-The [Charm development best practices](https://juju.is/docs/sdk/styleguide) are
-incorporated by reference.
+The
+[How to write and structure charm code](https://documentation.ubuntu.com/ops/latest/howto/write-and-structure-charm-code)
+is incorporated by reference.
 
 ## Definitions