Skip to content

Add version-specific titles to TypeDoc documentation#38

Merged
theroyalwhee0 merged 2 commits intomainfrom
37-add-version-specific-titles-to-typedoc-documentation
Nov 4, 2025
Merged

Add version-specific titles to TypeDoc documentation#38
theroyalwhee0 merged 2 commits intomainfrom
37-add-version-specific-titles-to-typedoc-documentation

Conversation

@theroyalwhee0
Copy link
Owner

Summary

  • Generate different documentation titles for releases vs unreleased builds
  • Released: "CommonProps Documentation - v0.1.2"
  • Unreleased: "CommonProps Documentation - Unreleased"

Changes

  • Update docs workflow to pass --name and --includeVersion false flags to TypeDoc
  • Use existing is_release detection to conditionally set documentation title
  • Version is dynamically inserted from package.json for release builds

Testing

Tested locally with both formats:

  • npx typedoc --name "CommonProps Documentation - Unreleased" --includeVersion false
  • npx typedoc --name "CommonProps Documentation - v0.1.2" --includeVersion false
  • Verified page titles render correctly in generated HTML
  • Pre-commit hooks pass (linting, tests, docs generation)

Benefits

  • Clear distinction between stable releases and development documentation
  • Users can easily identify which version they're viewing
  • Maintains consistency with versioned documentation directories

Resolves #37

Update documentation workflow to generate different titles for released
and unreleased documentation:

- Released builds: "CommonProps Documentation - v0.1.2" (with version)
- Unreleased builds: "CommonProps Documentation - Unreleased"

Implementation:
- Pass --name flag to TypeDoc CLI with conditional logic
- Pass --includeVersion false to prevent double version suffix
- Use existing is_release detection from workflow

Testing:
- Verified locally with both release and unreleased name formats
- Confirmed page titles render correctly in generated HTML

Resolves #37
@theroyalwhee0 theroyalwhee0 linked an issue Nov 4, 2025 that may be closed by this pull request
Update API section in README to clearly explain the two documentation
versions available:

- Latest: Points to most recent stable release documentation
- Unreleased: Points to current main branch documentation (may include
  unreleased features)

This helps users understand which documentation version to use based on
their needs and clarifies the difference between stable and development
documentation.
@theroyalwhee0 theroyalwhee0 self-assigned this Nov 4, 2025
@theroyalwhee0 theroyalwhee0 added 📚 documentation Improvements or additions to documentation 🔧 tooling Build tools, CI/CD, dev workflow labels Nov 4, 2025
@theroyalwhee0 theroyalwhee0 merged commit 2bd4ce0 into main Nov 4, 2025
1 check passed
@theroyalwhee0 theroyalwhee0 deleted the 37-add-version-specific-titles-to-typedoc-documentation branch November 4, 2025 01:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📚 documentation Improvements or additions to documentation 🔧 tooling Build tools, CI/CD, dev workflow

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add version-specific titles to TypeDoc documentation

1 participant