Skip to content

README links to the documentation website, social preview image - #39

Merged
firsttris merged 1 commit into
mainfrom
claude/mk-docs-ci-job-syuvsx
Oct 8, 2026
Merged

firsttris merged 1 commit into
mainfrom
claude/mk-docs-ci-job-syuvsx

Conversation

@firsttris

Copy link
Copy Markdown
Owner

What

README links point to the documentation website. Both READMEs linked the Markdown files in docs/. They now link the pages on https://firsttris.github.io/reactive-volcano-app/docs/ (docs/usage.md → …/docs/usage.html, docs/README.md → …/docs/), anchors included. Images stay relative, so they still render on GitHub. The links also work in the Docker Hub description, where relative links were broken.

Social preview image (1280 × 640). docs/social-preview.png, rendered from scripts/social-preview/social-preview.html with npm run social-preview: app icon, name, the supported devices, four feature chips, the "unofficial" note, and the Volcano, Venty and Crafty screenshots. Same approach as in ccu-addon-mui. docs/development.md describes it.

GitHub does not read the image from the repository: it has to be uploaded once under Settings → General → Social preview.

Checked

  • mkdocs build --strict passes; the anchors #install-as-an-app, #linux and #updates exist on the built pages.
  • npm run lint passes.
  • The image is 1280 × 640.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Pbr82fad6qrixb8849N4wK


Generated by Claude Code

- Both READMEs link the documentation pages on
  https://firsttris.github.io/reactive-volcano-app/docs/ instead of the
  Markdown files in docs/; images stay relative so they render on GitHub
- docs/social-preview.png (1280 × 640) for Settings → Social preview,
  rendered from scripts/social-preview/social-preview.html with
  npm run social-preview, documented in development.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pbr82fad6qrixb8849N4wK
@firsttris
firsttris merged commit 38fe606 into main Oct 8, 2026
6 checks passed
@firsttris
firsttris deleted the claude/mk-docs-ci-job-syuvsx branch October 16, 2026 10:26
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.

2 participants