Skip to content

Drop tutorials from jsdoc — they live natively in sitespeed.io now#2464

Merged
soulgalore merged 1 commit intomainfrom
drop-tutorials
May 7, 2026
Merged

Drop tutorials from jsdoc — they live natively in sitespeed.io now#2464
soulgalore merged 1 commit intomainfrom
drop-tutorials

Conversation

@soulgalore
Copy link
Copy Markdown
Member

The 14 scripting tutorials lived in jsdoc/tutorials/ and were rendered by clean-jsdoc-theme alongside the auto-generated class API docs. The sitespeed.io repo has now imported those markdown sources directly so they render with the rest of the site's docs (default layout, native TOC, syntax highlighting, copy buttons, image scaling). The jsdoc build no longer needs to ship them.

What this PR does:

  • delete jsdoc/tutorials/ and tutorials.json
  • drop the "tutorials" entry from jsdoc/jsdoc.json and remove the "Tutorials" section header from the theme config
  • point the README's "Getting Started" links at the new sitespeed.io tutorial URLs (the old Tutorial-01-Introduction.html link was already broken — capital T did not match the lowercase filename)

The class API reference (Commands, Measure, Click, …) keeps generating exactly as before, into the same path in the sitespeed.io repo.

Co-authored-by: Claude Opus 4.7 (1M context) noreply@anthropic.com
Change-Id: I9a5a736e126ef33386e1610d939b2df2344ef091

The 14 scripting tutorials lived in jsdoc/tutorials/ and were rendered
by clean-jsdoc-theme alongside the auto-generated class API docs. The
sitespeed.io repo has now imported those markdown sources directly so
they render with the rest of the site's docs (default layout, native
TOC, syntax highlighting, copy buttons, image scaling). The jsdoc
build no longer needs to ship them.

What this PR does:
 - delete jsdoc/tutorials/ and tutorials.json
 - drop the "tutorials" entry from jsdoc/jsdoc.json and remove the
  "Tutorials" section header from the theme config
 - point the README's "Getting Started" links at the new sitespeed.io
  tutorial URLs (the old Tutorial-01-Introduction.html link was
  already broken — capital T did not match the lowercase filename)

The class API reference (Commands, Measure, Click, …) keeps generating
exactly as before, into the same path in the sitespeed.io repo.

Co-authored-by: Claude Opus 4.7 (1M context) noreply@anthropic.com
Change-Id: I9a5a736e126ef33386e1610d939b2df2344ef091
@soulgalore soulgalore merged commit 3ac300f into main May 7, 2026
16 of 17 checks passed
@soulgalore soulgalore deleted the drop-tutorials branch May 7, 2026 20:43
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