Skip to content

docs: apply the docs style guide - #110

Merged
vbreuss merged 1 commit into
mainfrom
docs/apply-style-guide
Oct 31, 2026
Merged

vbreuss merged 1 commit into
mainfrom
docs/apply-style-guide

Conversation

@vbreuss

@vbreuss vbreuss commented Oct 31, 2026

Copy link
Copy Markdown
Member

Aligns the automated migration docs with the shared docs style guide of docs.testably.org and makes the per-library details easier to find.

  • The single 11-migration.md page is split into a 01-automated/ folder: an overview (installation, applying the fixes, manual review) and one page each for Moq and NSubstitute. They are served at /Mockolate/migration/automated/ (/moq, /nsubstitute), so the slug is no longer needed and PackageProjectUrl gets the trailing slash.
  • Every page has a description and an H1, installation uses <PackageInstall> under ## Installation, and the relative links into the Mockolate docs follow its new NN- folder names one level deeper.
  • The README links to the docs page.
  • AGENTS.md gets the guide's short rules in a ## Documentation section, and the agent docs point to the new pages and explain how their links resolve on the site.

Aligns the automated migration docs with the shared docs style guide of docs.testably.org and makes the per-library details easier to find.

- The single `11-migration.md` page is split into a `01-automated/` folder: an overview (installation, applying the fixes, manual review) and one page each for Moq and NSubstitute. They are served at /Mockolate/migration/automated/ (/moq, /nsubstitute), so the `slug` is no longer needed and `PackageProjectUrl` gets the trailing slash.
- Every page has a `description` and an H1, installation uses `<PackageInstall>` under `## Installation`, and the relative links into the Mockolate docs follow its new `NN-` folder names one level deeper.
- The README links to the docs page.
- AGENTS.md gets the guide's short rules in a `## Documentation` section, and the agent docs point to the new pages and explain how their links resolve on the site.
@vbreuss vbreuss self-assigned this Oct 31, 2026
Copilot AI balanced review requested due to automatic review settings October 31, 2026 11:32

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

@vbreuss
vbreuss merged commit f9c727b into main Oct 31, 2026
6 checks passed
@vbreuss
vbreuss deleted the docs/apply-style-guide branch October 31, 2026 11:38
@sonarqubecloud

Copy link
Copy Markdown

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