Skip to content

docs: restructure README into a getting-started page with docs sub-pages#336

Merged
vbreuss merged 1 commit into
mainfrom
docs/restructure-documentation
Jun 6, 2026
Merged

docs: restructure README into a getting-started page with docs sub-pages#336
vbreuss merged 1 commit into
mainfrom
docs/restructure-documentation

Conversation

@vbreuss
Copy link
Copy Markdown
Member

@vbreuss vbreuss commented Jun 6, 2026

Slim the README down to an introduction (at a glance, real-world examples, architecture rules teaser) and move the reference content into dedicated documentation sub-pages for docs.testably.org:

  • 01-sources: the In/Types sources and navigation
  • 02-filters: the complete filter/assertion reference, string matching options and quantifiers (negation notes as admonitions)
  • 03-architecture-rules: type dependencies, dependency cycles and layers (caveats as admonitions)
  • 04-configuration: assembly exclusions, compiler-generated members and the dependency resolver
  • comparison/: the FluentAssertions comparison (moved, converted to synced tabs) and a new NetArchTest/ArchUnitNET comparison

The NN- prefixes keep the sidebar order; URLs are unaffected by the renumbering since Docusaurus strips the prefix. The FluentAssertions comparison URL gains a /comparison/ segment.

@vbreuss vbreuss self-assigned this Jun 6, 2026
@vbreuss vbreuss added the documentation Improvements or additions to documentation label Jun 6, 2026
Slim the README down to an introduction (at a glance, real-world examples, architecture rules teaser) and move the reference content into dedicated documentation sub-pages for docs.testably.org:

- 01-sources: the In/Types sources and navigation
- 02-filters: the complete filter/assertion reference, string matching options and quantifiers (negation notes as admonitions)
- 03-architecture-rules: type dependencies, dependency cycles and layers (caveats as admonitions)
- 04-configuration: assembly exclusions, compiler-generated members and the dependency resolver
- comparison/: the FluentAssertions comparison (moved, converted to synced tabs) and a new NetArchTest/ArchUnitNET comparison

The NN- prefixes keep the sidebar order; URLs are unaffected by the renumbering since Docusaurus strips the prefix. The FluentAssertions comparison URL gains a /comparison/ segment.
@vbreuss vbreuss force-pushed the docs/restructure-documentation branch from b643645 to 0218bb3 Compare June 6, 2026 11:46
@vbreuss vbreuss merged commit 4079331 into main Jun 6, 2026
8 checks passed
@vbreuss vbreuss deleted the docs/restructure-documentation branch June 6, 2026 11:47
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 6, 2026

🚀 Benchmark Results

Details

BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)
AMD EPYC 9V74 2.87GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 10.0.300
[Host] : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3
DefaultJob : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3

Method Mean Error StdDev Gen0 Allocated
TypeIsNotStatic_aweXpect 213.6 ns 1.03 ns 0.92 ns 0.0386 648 B

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 6, 2026

👽 Mutation Results

Mutation testing badge

aweXpect.Reflection

Details
File Score Killed Survived Timeout No Coverage Ignored Compile Errors Total Detected Total Undetected Total Mutants

The final mutation score is NaN%

Coverage Thresholds: high:80 low:60 break:0

@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented Jun 6, 2026

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 7, 2026

This is addressed in release v2.0.0.

@github-actions github-actions Bot added the state: released The issue is released label Jun 7, 2026
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 state: released The issue is released

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant