Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
20ac0a8
initial docusaurus spike
heskew Jul 1, 2025
070909f
more forgiving script arg parsing and chipping away at doc dino error…
heskew Jul 2, 2025
f876fe6
handling conversions needed to resolve rendering errors in docusaurus…
heskew Jul 2, 2025
497e20c
docudino updates
heskew Jul 19, 2025
32584b7
updated migration plan and status. added redirects info. added mermai…
heskew Jul 20, 2025
f2ba1ce
delete a bunch of unecessary things for new docs site
Ethan-Arrowood Jul 22, 2025
5345288
stylistic changes to new docs site. (#196)
Ethan-Arrowood Jul 23, 2025
adaf813
run docusaurus in documentation, leaving harperdb for a later phase
heskew Jul 23, 2025
bc15d94
adjust dark theme color to use green (#206)
Ethan-Arrowood Jul 30, 2025
bada146
Add reo.dev for production only (#207)
Ethan-Arrowood Jul 31, 2025
6f1d969
aggregate and convert all release docs. other fine tuning to do still…
heskew Aug 1, 2025
45ca25d
keep latest docs in /docs
heskew Aug 1, 2025
c415fa3
another link fix
heskew Aug 1, 2025
23d4ca7
move the converted latest docs after restoring the branch to not have…
heskew Aug 1, 2025
aef124a
sidebar ordering adjustments during migration
heskew Aug 4, 2025
647aacc
get site:build running without errors and adding a tmp site:reset for…
heskew Aug 7, 2025
cbf8cdd
add gh pages template from docusaurus
Ethan-Arrowood Aug 4, 2025
939c563
deploy on a couple additional branches for now, only deploy on those …
heskew Aug 7, 2025
534a280
add some debug output on build and upload npm logs on failure
heskew Aug 7, 2025
368974f
remove wip branch from trigger and allowed deploy list
heskew Aug 8, 2025
db33911
add open graph image (#215)
Ethan-Arrowood Aug 8, 2025
66835f8
Fixing root index migration and more link fixes
heskew Aug 8, 2025
7605d33
more output for the (temporary) migration stage for more clarity in ci
heskew Aug 8, 2025
89e0289
allow the docusaurus baseUrl to vary
heskew Aug 8, 2025
b4f6d17
pass config through to build script
heskew Aug 8, 2025
9b75816
docs at the root
heskew Aug 8, 2025
d630b81
client redirects
heskew Aug 9, 2025
ca6cf48
quick and simple gb cards conversion on migration
heskew Aug 9, 2025
b6fa375
workflow updates and some post-migration prep
heskew Aug 10, 2025
ab3328e
Don't touch /docs for now
heskew Aug 11, 2025
a8d348f
exposing more env vars for the build
heskew Aug 11, 2025
59b594a
more debug output in the build
heskew Aug 11, 2025
7f68b63
remove explicit latest version
heskew Aug 11, 2025
9fcce40
no banner on 4.5
Ethan-Arrowood Aug 11, 2025
a31c366
rework some version paths and sidebar
heskew Aug 11, 2025
0bd286b
just warn on broken links until we've migrated and manually touched u…
heskew Aug 11, 2025
df40deb
complete initial local/client search setup
heskew Aug 11, 2025
1d199e7
docusaurus conversion
heskew Aug 12, 2025
9a3e3dd
migration planning docs cleanup
heskew Aug 12, 2025
7f5f46f
site readme cleanup
heskew Aug 12, 2025
087cb5f
only deploy main branch
heskew Aug 12, 2025
c9e4c05
make better use of the base path var
heskew Aug 12, 2025
f703bcb
allow publishing from the wip replatform branch for a little longer
heskew Aug 12, 2025
ba295ed
also pipe DOCUSAURUS_ROUTE_BASE_PATH through to the build job
heskew Aug 12, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
119 changes: 0 additions & 119 deletions .gitbook.yaml

This file was deleted.

101 changes: 101 additions & 0 deletions .github/workflows/deploy.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
name: Deploy Docusaurus to GitHub Pages

on:
# Trigger the workflow on pull requests and pushes to specific branches
pull_request:
push:
branches:
- main
- docs-in-hdb
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:

# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these deployments to complete.
# This shouldn't be necessary for most cases, but it can help avoid conflicts if multiple pushes happen in quick succession.
concurrency:
group: "pages"
cancel-in-progress: false

jobs:
build:
name: Build Docusaurus
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0

- uses: actions/setup-node@v4
with:
node-version: '22'
cache: 'npm'
cache-dependency-path: 'package-lock.json'

- name: Debug - Show directory structure
run: |
echo "Current directory: $(pwd)"
echo "Repository root contents:"
ls -la
echo "Site directory contents:"
ls -la site/ || echo "Site directory not found"
echo "Looking for package.json files:"
find . -name "package.json" -type f

- name: Install root dependencies
run: |
echo "Installing root dependencies from $(pwd)"
npm ci || (echo "Root npm ci failed, uploading logs" && exit 1)

- name: Install site dependencies
run: |
echo "Installing site dependencies..."
npm run site:install || (echo "Site install failed" && exit 1)

- name: Build Docusaurus site
env:
DOCUSAURUS_ROUTE_BASE_PATH: ${{ vars.DOCUSAURUS_ROUTE_BASE_PATH }}
DOCUSAURUS_BASE_URL: ${{ vars.DOCUSAURUS_BASE_URL }}
DOCUSAURUS_URL: ${{ vars.DOCUSAURUS_URL }}
IMAGES_PATH: ${{ vars.IMAGES_PATH }}
run: |
echo "Building Docusaurus site..."
echo "Using DOCUSAURUS_ROUTE_BASE_PATH: $DOCUSAURUS_ROUTE_BASE_PATH"
echo "Using DOCUSAURUS_BASE_URL: $DOCUSAURUS_BASE_URL"
echo "Using DOCUSAURUS_URL: $DOCUSAURUS_URL"
echo "Using IMAGES_PATH: $IMAGES_PATH"
npm run site:build || (echo "Site build failed" && exit 1)

- name: Upload npm logs on failure
if: failure()
uses: actions/upload-artifact@v4
with:
name: npm-logs
path: |
~/.npm/_logs/

- name: Upload Build Artifact
uses: actions/upload-pages-artifact@v3
with:
path: site/build

deploy:
needs: build
name: Deploy to GitHub Pages
runs-on: ubuntu-latest
# Only deploy on push to specific branches, not on PRs
if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/docs-in-hdb')

permissions:
pages: write
id-token: write

environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}


steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
2 changes: 2 additions & 0 deletions .prettierignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Keep this file minimized
site/static/js/reo.js
17 changes: 0 additions & 17 deletions docs/README.md

This file was deleted.

Loading