chore(ide): configure markdown linting and devcontainer setup

- Configure markdownlint to enforce 70-character line length
- Add Prettier configuration for markdown formatting with 70-char wrap
- Enable format-on-save and linting for markdown files in VS Code
- Add devcontainer configuration with Python 3.14 and required dependencies
- Configure devcontainer with markdown formatting extensions pre-installed

Author: jgeluk

.devcontainer/devcontainer.json

@@ -0,0 +1,56 @@
+{
+  "name": "Use Case Tree Method Documentation",
+  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
+  
+  "features": {
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.14"
+    },
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+
+  "postCreateCommand": "bash .devcontainer/post-create.sh",
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "esbenp.prettier-vscode",
+        "DavidAnson.vscode-markdownlint",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "squidfunk.mkdocs-material"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/local/bin/python",
+        "python.linting.enabled": true,
+        "python.linting.pylintEnabled": false,
+        "python.formatting.provider": "none",
+        "[python]": {
+          "editor.defaultFormatter": "ms-python.black-formatter",
+          "editor.formatOnSave": true
+        },
+        "[markdown]": {
+          "editor.formatOnSave": true,
+          "editor.defaultFormatter": "esbenp.prettier-vscode",
+          "editor.rulers": [70],
+          "editor.wordWrap": "off"
+        },
+        "markdownlint.run": "onSave",
+        "markdownlint.fixOnSave": true,
+        "prettier.printWidth": 70,
+        "prettier.proseWrap": "always"
+      }
+    }
+  },
+
+  "remoteEnv": {
+    "VIRTUAL_ENV": "${containerWorkspaceFolder}/.venv",
+    "PATH": "${containerWorkspaceFolder}/.venv/bin:${env:HOME}/.cargo/bin:${containerEnv:PATH}"
+  },
+
+  "forwardPorts": [8000],
+
+  "postStartCommand": "echo 'Dev container ready!'"
+}
+

.devcontainer/post-create.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Setting up Use Case Tree Method dev container..."
+
+# Install system dependencies
+echo "📦 Installing system dependencies..."
+apt-get update
+apt-get install -y \
+  build-essential \
+  libcairo2-dev \
+  libfreetype6-dev \
+  libffi-dev \
+  libpango1.0-dev \
+  libjpeg-dev \
+  libpng-dev \
+  zlib1g-dev \
+  graphviz \
+  curl
+
+# Install uv
+echo "📦 Installing uv..."
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Add uv to PATH for current session and future sessions
+export PATH="$HOME/.cargo/bin:$PATH"
+echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
+
+# Verify uv installation
+if ! command -v uv &> /dev/null; then
+  echo "❌ Failed to install uv"
+  exit 1
+fi
+
+echo "✅ uv installed: $(uv --version)"
+
+# Install Python dependencies
+echo "📦 Installing Python dependencies..."
+uv sync
+
+echo "✅ Dev container setup complete!"
+echo ""
+echo "You can now run:"
+echo "  - make docs-serve    (start MkDocs server)"
+echo "  - make docs-build    (build documentation)"
+echo "  - uv run mkdocs --help"
+

.devcontainerignore

@@ -0,0 +1,12 @@
+**/.git
+**/.venv
+**/node_modules
+**/site
+**/__pycache__
+**/*.pyc
+**/.pytest_cache
+**/.mypy_cache
+**/dist
+**/build
+**/*.egg-info
+

.markdownlint.json

@@ -1,8 +1,8 @@
 {
   "MD013": {
-    "line_length": 140,
-    "heading_line_length": 140,
-    "code_block_line_length": 140
+    "line_length": 70,
+    "heading_line_length": 70,
+    "code_block_line_length": 70
   },
   "MD025": {
     "front_matter_title": ""

.prettierrc.json

@@ -0,0 +1,14 @@
+{
+  "printWidth": 70,
+  "proseWrap": "always",
+  "overrides": [
+    {
+      "files": "*.md",
+      "options": {
+        "printWidth": 70,
+        "proseWrap": "always"
+      }
+    }
+  ]
+}
+

.vscode/settings.json

@@ -6,5 +6,15 @@
     "tag:yaml.org,2002:python/name",
     "tag:yaml.org,2002:python/object/apply"
   ],
-  "makefile.configureOnOpen": false
+  "makefile.configureOnOpen": false,
+  "[markdown]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.rulers": [70],
+    "editor.wordWrap": "off"
+  },
+  "markdownlint.run": "onSave",
+  "markdownlint.fixOnSave": true,
+  "prettier.printWidth": 70,
+  "prettier.proseWrap": "always"
 }