refactor(v2.0.0 release): user-defined tags, project storage, and documentation standards#9
Merged
bryan-shea merged 3 commits intomainfrom Feb 1, 2026
Merged
Conversation
BREAKING CHANGE: Removed all preset tags in favor of user-defined system - Implemented project-scoped .annotative folder for isolated storage - Streamlined all command messages for concise, professional UX - Enhanced tag management with create, edit, delete workflows - Added custom status support to annotation storage - Improved error handling and user feedback across all commands - Updated storage manager to auto-create project-specific folders
- Rewrite README with accurate terminology and professional tone - Remove all emojis from user-facing content - Update CONTRIBUTING with comprehensive developer guidelines - Standardize CHANGELOG format and remove git hashes - Update package.json description to match documentation tone - Remove emojis from color picker labels in extension code - Update copilot-instructions to reflect current architecture - Add SUPPORT.md for user assistance All documentation now uses exact command names and terminology from the extension, maintains a professional tone, and follows established standards.
There was a problem hiding this comment.
Pull request overview
This pull request implements v2.0.0 of the Annotative extension, introducing user-defined tags as a replacement for preset tags and streamlining documentation and user messaging. This is a major breaking change release that removes all preset tag functionality.
Changes:
- Removed all preset tags (bug, performance, security, etc.) in favor of a fully user-defined tag system
- Streamlined command messages and UI text throughout the extension for consistency
- Comprehensive documentation rewrite including README, CONTRIBUTING, CHANGELOG, and new SUPPORT.md
- Added AnnotationStatus interface for future status management (not yet implemented)
- Enhanced project storage with auto-creation on first use
- Removed emojis from color palette labels in extension code
Reviewed changes
Copilot reviewed 20 out of 20 changed files in this pull request and generated 17 comments.
Show a summary per file
| File | Description |
|---|---|
| src/types.ts | Added AnnotationStatus interface and updated tag/annotation comments to reflect user-defined system |
| src/tags/tagRegistry.ts | Removed all preset tag initialization, now returns empty array for presets |
| src/tags/tagManager.ts | Updated methods to work exclusively with custom tags, deprecated preset methods |
| src/managers/annotationStorage.ts | Added status persistence, auto-creates project storage, deprecated old initialization method |
| src/extension.ts | Removed emoji icons from color palette labels |
| src/commands/tags.ts | Updated all tag commands to handle empty tag state and guide users to create tags |
| src/commands/sidebar.ts | Streamlined storage initialization messages |
| src/commands/filters.ts | Shortened UI messages for consistency |
| src/commands/export.ts | Condensed success/error messages throughout |
| src/commands/bulk.ts | Added tag existence checks before bulk tag operations |
| src/commands/annotation.ts | Updated templates to have empty tag arrays, improved tag selection flow |
| media/sidebar-webview.js | Updated to handle user-defined tags only with empty state |
| package.json | Updated command titles and descriptions, configuration labels shortened |
| README.md | Complete rewrite with professional tone, accurate terminology, structured sections |
| CONTRIBUTING.md | Expanded with detailed development setup, architecture, and standards |
| CHANGELOG.md | Standardized format with consistent structure |
| SUPPORT.md | New file providing user support resources and troubleshooting |
| .github/copilot-instructions.md | Updated with accurate architecture, removed emoji policy |
| .husky/pre-commit | Removed shebang and husky initialization lines |
| .husky/commit-msg | Removed shebang and husky initialization lines |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR Description
v2.0.0 Release
This major release introduces a simplified UX through user-defined tags and project-scoped storage, alongside comprehensive documentation standards. This is a breaking change release due to the removal of preset tags.
Previous Version: v1.5.0 (Dec 26, 2025)
New Version: v2.0.0
Breaking Changes⚠️
User-Defined Tags System (Major Change)
Migration Guide: Users upgrading from v1.5.0 will need to create custom tags matching their previous workflows. Documentation includes recommended tag templates for common use cases.
Core Changes
Architecture & Storage
.annotative/folder for isolated, portable storageUX Improvements
Documentation Standards
Files Changed
Testing Recommendations
.annotative/folderRelated Issues
Addresses simplification of tag system and documentation standardization across the project.
Version Bump Justification
Semantic Versioning: Major version bump (2.0.0) due to breaking change in tag system API.