Releases & versioning
Predictable versions, documented changes
Every release is tagged on GitHub, published to NuGet, and recorded in a changelog — so you can see exactly what changed before you upgrade.
Versioning policy
- Semantic versioning. All three packages follow SemVer:
major.minor.patch. - Breaking changes only in major versions. Within a major version, upgrades are source compatible — minor versions add features, patch versions fix bugs.
- Independent release cadence. The packages version independently; there is no lockstep "suite version" and no cross-package dependency, so upgrading one never forces upgrading another.
- Security fixes target the latest release of each package — see the security policy.
Current versions
TerraFluent.Pdf.Reporting 2.0.2
TerraFluent.Html.Reporting 1.1.1
TerraFluent.Docx.Reporting 1.3.0
Deprecation
If an API needs to go away, it is marked [Obsolete] with a message
pointing at the replacement for at least one minor release before being removed in
the next major version. Removals are always listed in the changelog.