Skip to content

User docs build fails: docs/screenshots/README.md has no title #34

Description

@cewert

What happens

Building the user docs from current jellyrock/jellyrock main fails:

[InvalidContentEntryDataError] docs → screenshots/readme data does not match collection schema.
  title: Required

Reproduced on 2026-09-14 with a fresh clone of this repo, npm ci, and npm run build:user (the same path deploy.yml runs), against jellyrock main at 9469f68.

Why

shared/fetch-docs.mjs copies docs/screenshots/ into src/content/docs/screenshots with a plain fs.cpSync. Only files under docs/user go through copyMarkdownWithFrontmatter, which adds the Starlight title. docs/screenshots/README.md is a generated gallery page with no frontmatter, so the content schema rejects it.

When it started

docs/screenshots/README.md was added in jellyrock 66021624 (2026-06-10). The last successful deploy of this repo was on 2026-06-09, so no deploy has run since the file appeared. The next one will fail at this step.

Possible fixes

  • Copy only the image files from docs/screenshots (the markdown pages reference the images, not the README).
  • Or skip *.md when copying that folder.

Deleting the file from the copied content lets the build finish (verified locally).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions