You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Added
A documentation site at https://propertybag.ncode.io/, built from docs/site/ by the shared NCodeGroup/docs toolchain: a quick start, a guide for each task, the concepts behind keys and the default bag, and an API map of every public member, which the gate checks against both PublicAPI.Shipped.txt files. .github/workflows/docs.yml builds it on every pull request and publishes it from main (#37, ADR-1005, ADR-1008, ADR-1009).
Every C# sample on the site is a compiled test in tests/NCode.PropertyBag.Site.Tests that uses only the public API, and the gate checks every sample's marker and key (#37, ADR-1006).
The gate compiles every example in the XML documentation of src/ against both packages (build/Test-XmlDocExamples.ps1), so each example IntelliSense shows builds as written (#37).
Changed
Package validation compares each package with the published 2.0.0 package.
The repository README and both package READMEs link to the documentation site (#37).
The XML documentation of IReadOnlyPropertyBag.Clone says that how values are copied is up to the implementation, and that the default implementation clones each ICloneable value, as the README and the documentation site say; it described every copy as shallow.
The README samples check is build/Assert-Markdown.ps1, which the gate tests offline first; it reads file names as git stores them and fails when git fails, where a failure read as "nothing changed" (#37).