feat: scaffold the new documentation for Databús

Author: fabianabarca

.github/workflows/docs.yml

@@ -0,0 +1,32 @@
+name: Databús Documentation
+on:
+  push:
+    branches:
+      - main
+      - docs
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - uses: actions/configure-pages@v6
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - run: pip install zensical mkdocstrings[python]
+      - run: zensical build --clean
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: docs/site
+      - uses: actions/deploy-pages@v5
+        id: deployment

.gitignore

@@ -8,6 +8,9 @@ publisher/feed/files/*.pb
 publisher/feed/files/*.json
 gtfs/
 
+# Zensical
+site/
+
 # Ubuntu server
 restart_services.sh
 

docs/.python-version

@@ -0,0 +1 @@
+3.14

docs/README.md

@@ -0,0 +1,3 @@
+# Databús Documentation
+
+This is the documentation for the Databús platform.

docs/content/index.md

@@ -0,0 +1,11 @@
+---
+icon: lucide/map-pin
+---
+
+# Overview
+
+Databús is a platform for managing and publishing GTFS data. 
+
+!!! warning "Work in Progress"
+
+    Both Databús and its documentation are currently under active development. Estimated release date is August 2026.

docs/content/sections.md

@@ -0,0 +1,14 @@
+---
+icon: lucide/files
+---
+
+# Sections
+
+These are the future sections of the documentation. 
+
+1. Conceptual Overview
+2. Architecture
+3. Processes
+4. Data Model
+5. Operations
+6. Interfaces

docs/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from docs!")
+
+
+if __name__ == "__main__":
+    main()