Version History
Each icon, SVG, and annotation receives a version identifier and clear upgrade signals.
Every asset in CommonsSymbols follows semantic versioning: major for breaking changes, minor for additions, patch for fixes. Repository commits tie directly to version tags, making it simple to compare changes across releases. The changelog includes file-level diffs and migration notes.
When a symbol is deprecated, its file includes a YAML header with the deprecation version, recommended replacement, and removal timeline. Developers can query the version manifest to find stable, deprecated, or upcoming symbols—no guesswork required for long-term maintenance planning.
Backward compatibility is prioritized: deprecated assets remain in the repository, flagged but functional, until removal in the next major version. This gives teams time to adapt workflows and update downstream dependencies without sudden disruptions.
