Skip to content

docs: fix 404 at ossia.io/libossia/ - #963

Merged
jcelerier merged 1 commit into
masterfrom
docs-root-redirect
Oct 18, 2026
Merged

jcelerier merged 1 commit into
masterfrom
docs-root-redirect

Conversation

@jcelerier

Copy link
Copy Markdown
Member

Problem

GitHub Pages serves this repository's gh-pages branch at https://ossia.io/libossia/, which shadows that path on the main website (ossia/ossia.github.io). The branch only contains html/ (the Doxygen output), so:

  • https://ossia.io/libossia/ → 404
  • the redirect page that ossia.github.io builds for /libossia/ is never served

Fix

The Build Documentation step now also writes publish/index.html, which redirects to https://ossia.io/site-libossia/about.html (meta refresh + canonical) and links to the API docs in html/. Nothing else changes: the docs stay at /libossia/html/.

Tested by running the step's script locally with Doxygen stubbed out: publish/ contains index.html and html/.

Note (not changed here)

The workflow also runs on pull_request, and the deploy step has no condition, so a PR from a branch of this repo can overwrite the published docs. Adding if: github.event_name != 'pull_request' to Deploy Documentation would prevent that.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LnhJQb1bcRrYTvmX94BTzw

The gh-pages branch of this repository is served at ossia.io/libossia/
and shadows that path on the main website. Since the branch only
contains html/, https://ossia.io/libossia/ returned a 404.

Write a small index.html next to html/ that redirects to the libossia
page of the website and links to the API documentation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LnhJQb1bcRrYTvmX94BTzw
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier temporarily deployed to Apple Certificate October 18, 2026 21:01 — with GitHub Actions Inactive
@jcelerier
jcelerier marked this pull request as ready for review October 18, 2026 21:58
@jcelerier
jcelerier merged commit 3105206 into master Oct 18, 2026
39 of 42 checks passed

This branch was previously deployed

1 inactive deployment
Apple Certificate — 06fed717 Deployed Oct 18, 2026 by jcelerier via build-macos (1, Release) #1302
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant