Vortex Docs Reboot (vortex-data#6318)

Signed-off-by: Nicholas Gates <nick@nickgates.com>
Signed-off-by: Nicholas Gates <gatesn@users.noreply.github.com>
Co-authored-by: Dan King <dan@spiraldb.com>

Author: gatesn

.github/workflows/ci.yml

@@ -105,6 +105,8 @@ jobs:
         with:
           sync: false
           prune-cache: false
+      - name: Install Doxygen
+        uses: ssciwr/doxygen-install@v1
 
       - name: Pytest - Vortex
         run: |

.github/workflows/docs.yml

@@ -32,6 +32,12 @@ jobs:
         with:
           sync: false
           prune-cache: false
+      - name: Generate changelog from GitHub releases
+        run: uv run docs/generate_changelog.py
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Install Doxygen
+        uses: ssciwr/doxygen-install@v1
       - name: Generate Javadoc for Java projects
         run: |
           cd java

CONTRIBUTING.md

@@ -36,6 +36,7 @@ The contribution process is outlined below:
 3. Open a PR to indicate that the change is ready for review.
    - Ensure that you sign your work via DCO (see below).
    - Disclose LLM usage as described in [AI Assistance Notice](#ai-assistance-notice).
+   - CI requires approval from external committers.
 
 ## Governance
 
@@ -80,12 +81,9 @@ Our CI process enforces an extensive set of linter (e.g., `clippy`) rules, as we
 
 ## Reporting Issues
 
-The Vortex project triages all issues and feature requests via Discussions.
-
-See #5495 for background on this change.
-
-If you see something that you think is a bug, create a new Discussion and select "Issue Triage"
-for the template. Then fill out the form.
+Bugs should be filed as [GitHub Issues](https://github.com/vortex-data/vortex/issues). Open-ended
+questions and feature requests should be filed as
+[GitHub Discussions](https://github.com/vortex-data/vortex/discussions).
 
 ## Developer Certificate of Origin (DCO)
 

docs/Doxyfile.cpp

@@ -0,0 +1,31 @@
+# Doxygen configuration for Vortex C++ API documentation.
+# XML output is consumed by Sphinx via the Breathe extension.
+
+PROJECT_NAME           = "Vortex C++"
+OUTPUT_DIRECTORY       = _build/doxygen-cpp
+
+# Input sources
+INPUT                  = ../vortex-cxx/cpp/include/vortex
+FILE_PATTERNS          = *.hpp
+RECURSIVE              = NO
+
+# We only care about XML output for Breathe
+GENERATE_XML           = YES
+GENERATE_HTML          = NO
+GENERATE_LATEX         = NO
+XML_PROGRAMLISTING     = YES
+
+# Extract everything, even if not fully documented yet
+EXTRACT_ALL            = YES
+EXTRACT_PRIVATE        = NO
+EXTRACT_STATIC         = YES
+
+# Preprocessing — resolve includes but don't expand macros
+ENABLE_PREPROCESSING   = YES
+MACRO_EXPANSION        = NO
+
+# Suppress warnings about undocumented members (WIP API)
+WARN_IF_UNDOCUMENTED   = NO
+
+# Exclude cxx bridge internals from documentation
+EXCLUDE_SYMBOLS        = ffi::*

docs/Makefile

@@ -20,4 +20,5 @@ help:
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 serve:
-	sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)/html"
+	@rm -rf "$(BUILDDIR)"
+	sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)/html" --re-ignore '$(BUILDDIR)/.*'

docs/_static/style.css

@@ -1,3 +1,13 @@
+/* -- Landing page wordmark ------------------------------------------------ */
+
+.vortex-wordmark {
+    display: block;
+    max-width: min(400px, 100%);
+    margin: 1.5rem auto 2.5rem;
+}
+
+/* -- Headings ------------------------------------------------------------- */
+
 h2 {
     font-size: 1.75rem;
 }
@@ -8,4 +18,29 @@ h3 {
 
 h4 {
     font-size: 1.25rem;
-}
+}
+
+/* -- Landing page cards --------------------------------------------------- */
+
+.sd-card .sd-card-title {
+    font-size: 1.15rem;
+    font-weight: 600;
+    color: var(--pst-color-primary);
+    border-bottom: 1px solid var(--pst-color-border);
+    padding-bottom: 0.4rem;
+    margin-bottom: 0.6rem;
+}
+
+.sd-card .sd-card-body {
+    font-size: 0.92rem;
+    line-height: 1.55;
+}
+
+.sd-card {
+    transition: box-shadow 0.15s ease-in-out, border-color 0.15s ease-in-out;
+}
+
+.sd-card:hover {
+    border-color: var(--pst-color-primary);
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
+}