V0.5

.fastflowtransform/target/catalog.json

@@ -0,0 +1,11 @@
+{
+  "metadata": {
+    "generated_at": "2025-10-28T19:05:15+00:00",
+    "tool": "fastflowtransform"
+  },
+  "relations": {
+    "failing": {
+      "columns": []
+    }
+  }
+}

.fastflowtransform/target/manifest.json

@@ -0,0 +1,20 @@
+{
+  "macros": {
+    "snake": "text.py"
+  },
+  "metadata": {
+    "generated_at": "2025-10-28T19:05:15+00:00",
+    "tool": "fastflowtransform"
+  },
+  "nodes": {
+    "failing": {
+      "deps": [],
+      "kind": "sql",
+      "materialized": "table",
+      "name": "failing",
+      "path": "",
+      "relation": "failing"
+    }
+  },
+  "sources": {}
+}

.fastflowtransform/target/run_results.json

@@ -0,0 +1,19 @@
+{
+  "metadata": {
+    "generated_at": "2025-10-28T19:05:15+00:00",
+    "tool": "fastflowtransform"
+  },
+  "results": [
+    {
+      "duration_ms": 0,
+      "finished_at": "2025-10-28T19:05:15+00:00",
+      "http": null,
+      "message": "'boom'",
+      "name": "failing",
+      "started_at": "2025-10-28T19:05:15+00:00",
+      "status": "error"
+    }
+  ],
+  "run_finished_at": "2025-10-28T19:05:15+00:00",
+  "run_started_at": "2025-10-28T19:05:15+00:00"
+}

.github/workflows/pages.yml

@@ -0,0 +1,50 @@
+name: Build & Deploy MkDocs to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Build site
+        run: mkdocs build --strict
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+      - name: Deploy to Pages
+        uses: actions/deploy-pages@v4

.gitignore

@@ -39,3 +39,5 @@ dist/
 # Docs Output
 examples/**/docs/
 tickets/**
+site/dag/**
+cache/**

Makefile.pipeline

@@ -25,17 +25,17 @@ dag:
 # Opens the generated DAG HTML on macOS/Linux; Windows users open it manually.
 demo-open:
 	@if [ -f "$(FF_PROJECT)/site/dag/index.html" ]; then \
-		$(OPENER) "$(FF_PROJECT)/site/dag/index.html" 2>/dev/null || echo "Öffne manuell: $(FF_PROJECT)/site/dag/index.html"; \
+		$(OPENER) "$(FF_PROJECT)/site/dag/index.html" 2>/dev/null || echo "Oopen at: $(FF_PROJECT)/site/dag/index.html"; \
 	else \
-		echo "Keine HTML-Datei gefunden: $(FF_PROJECT)/site/dag/index.html"; \
+		echo "No HTML found: $(FF_PROJECT)/site/dag/index.html"; \
 	fi
 
 test:
 	$(FFT) test "$(FF_PROJECT)" --env "$(FF_ENV)" --select batch
 
 # End-to-end showcase: Seed → Run → DAG → Open → Tests
 demo: seed run dag demo-open test
-	@echo "\n✓ Demo fertig: Tabellen gebaut, DAG generiert, Tests gelaufen."
+	@echo "\n✓ Demo done."
 
 clean:
 	rm -rf .local "$(FF_PROJECT)/docs" dist build *.egg-info

README.md

@@ -68,7 +68,7 @@ make install      # upgrades pip + installs FastFlowTransform in editable mode
 ## Quickstart
 
 > 📚 **Mehr lesen … CLI-Details**
-> Für Flag-Referenzen, Automatisierung und Hintergründe siehe [`docs/Technical_Overview.md`](docs/Technical_Overview.md#cli-flows).
+> For flag referencees, automatization and backgrounds see [`docs/Technical_Overview.md`](docs/Technical_Overview.md#cli-flows).
 
 Run the end-to-end DuckDB demo (seed → run → docs → tests) in under a minute:
 
@@ -188,8 +188,11 @@ Examples:
 
 - **Documentation hub:** choose your path (operators vs contributors) — see [`docs/index.md`](docs/index.md).
 - **User & operator guide:** project layout, CLI usage, troubleshooting tips — see [`docs/Technical_Overview.md`](docs/Technical_Overview.md).
+- **Docgen shortcut:** append `--open-source` to `fft docgen ...` to launch the freshly rendered `index.html` immediately; use `--no-schema` when column introspection should be skipped.
 - **Modeling reference:** configuration, Jinja helpers, macros — see [`docs/Config_and_Macros.md`](docs/Config_and_Macros.md).
-- **Examples:** runnable demo projects live under `examples/`; each README covers engine-specific setup.
+- **API calls in Python models:** [`docs/API_Models.md`](docs/API_Models.md)
+- **Database comments sync:** preview database comment updates with `fft sync-db-comments . --env dev --dry-run` before applying them to Postgres or Snowflake.
+- **Examples:** runnable demo projects live under `examples/`;
 
 ---