Skip to content

Enhance Docusaurus documentation with versioning and autogenerated sidebar#80

Merged
tsutomi merged 5 commits into
mainfrom
versioned-documentation
Jun 10, 2026
Merged

Enhance Docusaurus documentation with versioning and autogenerated sidebar#80
tsutomi merged 5 commits into
mainfrom
versioned-documentation

Conversation

@tsutomi

@tsutomi tsutomi commented Jun 10, 2026

Copy link
Copy Markdown
Member

This pull request adds sidebar metadata to the documentation files to organize them within the documentation site's sidebar navigation. Each file now includes a sidebar_position attribute at the top, and a category configuration file was added for the connectors section. No code or content changes were made beyond documentation metadata.

Documentation sidebar organization:

  • Added sidebar_position frontmatter to all documentation Markdown files to define their order in the sidebar. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13]
  • Added sidebar_position frontmatter to all connector documentation files for consistent ordering in the connectors section. [1] [2] [3] [4] [5] [6]

Connectors category configuration:

  • Added _category_.json file in the docs/connectors directory to label and position the "Connectors" section in the sidebar.

tsutomi added 5 commits June 10, 2026 16:40
- Replace static sidebars.ts with autogenerated sidebar
- Add sidebar_position frontmatter to all docs
- Add _category_.json files for senders, connectors, samples
- Snapshot versioned docs at tags v1.0.5, v1.0.6, v1.1.1, v1.1.2
- Add version config with labels, paths, and banners
- Replace static navbar links with docsVersionDropdown
- Each version has an autogenerated sidebar from its own files
The 'Next' version represented unreleased in-development docs with no
corresponding NuGet package. Set includeCurrentVersion: false to hide it.
Versioned READMEs from git tags used relative path
src='ratatosk-full-logo.png' which Docusaurus doesn't
serve at the resolved position. Changed to /img/... to
point to the global static asset.
@tsutomi tsutomi self-assigned this Jun 10, 2026
Copilot AI review requested due to automatic review settings June 10, 2026 17:14
@tsutomi tsutomi linked an issue Jun 10, 2026 that may be closed by this pull request

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review this pull request because it exceeds the maximum number of lines (20,000). Try reducing the number of changed lines and requesting a review from Copilot again.

@tsutomi tsutomi merged commit 2528d2c into main Jun 10, 2026
11 checks passed
@tsutomi tsutomi deleted the versioned-documentation branch June 10, 2026 17:18
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.

Self-Host Docusaurus Documentation Site

2 participants