2026
February 2026
- Expanded the Build Reference page with additional failure mode documentation and common troubleshooting steps for dependency resolution errors.
- Added inline examples to the Reference section for multi-repository configuration variables.
- Clarified the distinction between required and optional TPL dependencies in the Developers Guide.
January 2026
- Added new pipeline patterns for matrix builds and conditional test stages.
- Reorganized the Guides section with clearer categories for package creation, dependency management, and testing.
- Updated the CI documentation with practical advice on build caching strategies.
- Minor corrections to macro signatures in the Reference section.
2025
December 2025
- Updated the Developers Guide sections on multi-repo workflow and superbuild configuration with clearer step-by-step instructions.
- Added a quick reference card section to the Downloads page.
- Clarified dependency declaration patterns in the Reference section.
November 2025
- Added troubleshooting table to the Build Reference with common symptoms, causes, and fixes.
- Improved code block formatting across all documentation pages.
- Updated security headers documentation.
October 2025
- Expanded the Maintainers Guide with new sections on flake handling and test quarantine practices.
- Minor wording improvements across multiple pages.
September 2025
- Added the Pipelines section with initial CI/CD patterns for TriBITS projects.
- Documented multi-repository CI pipeline configurations.
- Updated the homepage quick start map to include Pipelines.
August 2025
- Reorganized the Reference section. Variables are now grouped by category (enablement, testing, build config, multi-repo).
- Added macro signature details for
tribits_add_advanced_test().
July 2025
- Expanded the CI documentation with sections on test categories in CI, flaky test management, and build caching.
- Added platform-specific notes for GitHub Actions, GitLab CI, and Jenkins.
June 2025
- Updated the Guides section with a new guide on setting up multi-repository builds.
- Added common mistakes section to Guides with specific error patterns and fixes.
May 2025
- Added the Downloads page with presentation slides and quick reference cards.
- Created printable-friendly styles for documentation pages.
April 2025
- Expanded the Developers Guide FAQ with three additional items covering subpackage patterns and TPL configuration.
- Minor corrections to code examples in the Guides section.
March 2025
- Updated the About page with clearer descriptions of scope and limitations.
- Improved navigation consistency across all sections.
February 2025
- Added the Maintainers Guide with initial sections on dependency hygiene, CI stability, and versioning.
- Created the Contact page.
January 2025
- Initial publication of the Guides section covering package creation, dependency configuration, and test writing.
- Added sitemap generation.
2024
December 2024
- Published the Build Reference page with configuration variables, macro reference, and troubleshooting guide.
- Added search functionality.
November 2024
- Published the Reference section with core macro documentation and common configuration patterns.
- Improved sidebar navigation for docs sections.
October 2024
- Launched the CI documentation section with build-test loop patterns and incremental build guidance.
- Added test category documentation.
September 2024
- Published the Developers Guide covering project layout, configuration model, dependency graph, testing, and multi-repo workflows.
- Created the documentation hub page.
August 2024
- Added privacy policy and terms of use pages.
- Configured security headers and security.txt.
July 2024
- Initial site structure with homepage, documentation overview, and About page.
- Established the custom theme and visual design.
June 2024
- Project setup and framework selection. Chose VuePress v2 with custom theming.
- Created the initial content architecture and page plan.
About This Changelog
This changelog covers documentation and site content updates. It does not track changes to the TriBITS framework itself. Framework changes are documented in the project's source repository.
How to Read This Log
Entries are organized by month and year, with the most recent updates at the top. Each entry describes what changed in enough detail to help returning visitors find updated content. Entries fall into several categories:
New content means a page or section that did not previously exist. This includes entirely new pages, new subsections within existing pages, and new downloadable resources.
Expanded content means an existing section received additional detail, examples, or explanation. The original material is still present, but more information was added around it.
Reorganized content means the information was restructured without adding or removing material. This includes reordering sections, splitting a long page into multiple pages, or moving content between sections for better discoverability.
Corrections means errors were fixed. This includes incorrect variable names, wrong macro signatures, misleading examples, and factual errors. Typo fixes and minor wording improvements are grouped under "minor corrections" when they do not change the meaning of the content.
Site infrastructure means changes to the site itself rather than the documentation content. This includes theme updates, search improvements, navigation changes, and hosting configuration.
Update Frequency
The documentation is updated on a rolling basis as improvements are identified. There is no fixed release schedule. Months with more entries reflect periods of active documentation work. Months without entries indicate the content was stable and no changes were needed.
Reporting Missing Changes
If you notice that the documentation has changed but the changelog does not reflect it, this is a documentation bug. Please report it through the Contact page so we can add the missing entry. The goal is for this log to be a reliable record of every meaningful change to the site.
Relationship to Framework Versions
While the documentation tracks the TriBITS framework's features and behavior, documentation updates do not necessarily align with framework releases. A documentation update in March 2025 might describe a framework feature that was released months earlier. The changelog dates reflect when the documentation was updated, not when the underlying framework feature was introduced.