docs: Update project plan files
This commit is contained in:
@@ -1,21 +1,69 @@
|
||||
# StarPunk v1.3.0 Release
|
||||
|
||||
**Status**: Planning
|
||||
**Status**: Complete
|
||||
**Codename**: "Categories"
|
||||
**Branch**: `feature/v1.3.0-tags-microformats`
|
||||
**Approved**: 2025-12-10
|
||||
|
||||
## Features
|
||||
|
||||
### Strict Microformats2 Compliance
|
||||
- Complete h-entry properties (p-name, p-summary, p-author)
|
||||
- Author h-card implementation
|
||||
- h-feed wrapper for index pages
|
||||
- Full IndieWeb parser compatibility
|
||||
- Microformats2 validation suite
|
||||
- See: ADR-040
|
||||
### Tag/Category System (Complete)
|
||||
- Database schema for tags (`migrations/008_add_tags.sql`)
|
||||
- Tag management module (`starpunk/tags.py`)
|
||||
- Micropub category property support
|
||||
- Admin interface for tag editing
|
||||
- Tag archive pages (`/tag/<tag>`)
|
||||
- p-category microformats2 markup with `rel="tag"`
|
||||
|
||||
### Strict Microformats2 Compliance (Complete)
|
||||
- h-feed required properties: p-name, p-author (h-card), u-url, u-photo
|
||||
- h-entry p-category for tags
|
||||
- u-photo placement outside e-content per draft spec
|
||||
- Author h-card with u-photo and p-note (graceful fallback)
|
||||
- mf2py validation test suite
|
||||
|
||||
## Implementation Phases
|
||||
|
||||
1. **Phase 1: Database and Backend** - Complete
|
||||
- Migration 008 for tags schema
|
||||
- Tags module with normalization
|
||||
- Notes CRUD updated for tags parameter
|
||||
- Micropub integration
|
||||
|
||||
2. **Phase 2: Templates** - Complete
|
||||
- h-feed enhancements on index.html
|
||||
- p-category markup on note.html
|
||||
- Tag archive template (tag.html)
|
||||
|
||||
3. **Phase 3: Routes and Admin** - Complete
|
||||
- Tag archive route
|
||||
- Admin form tag input
|
||||
- Tags pre-loaded in routes
|
||||
|
||||
4. **Phase 4: Validation** - Complete
|
||||
- mf2py validation tests
|
||||
- Test fixtures for tags and media
|
||||
|
||||
## Bugs Addressed
|
||||
|
||||
*None planned*
|
||||
*None*
|
||||
|
||||
## Implementation
|
||||
## Known Limitations
|
||||
|
||||
See `docs/design/v1.3.0/` for implementation details and reports.
|
||||
- No pagination on tag archive pages (future enhancement)
|
||||
- No tag autocomplete in admin (future enhancement)
|
||||
- No tag-filtered feeds (moved to backlog)
|
||||
|
||||
## Test Results
|
||||
|
||||
- 333 tests passed
|
||||
- 1 pre-existing flaky test (unrelated to v1.3.0)
|
||||
- All microformats validation tests pass
|
||||
|
||||
## Documentation
|
||||
|
||||
- Design: `docs/design/v1.3.0/microformats-tags-design.md`
|
||||
- Phase 1 Report: `docs/design/v1.3.0/2025-12-10-phase1-implementation.md`
|
||||
- Phase 2 Report: `docs/design/v1.3.0/2025-12-10-phase2-implementation.md`
|
||||
- Phase 3 Report: `docs/design/v1.3.0/2025-12-10-phase3-implementation.md`
|
||||
- Phase 4 Report: `docs/design/v1.3.0/2025-12-10-phase4-implementation.md`
|
||||
|
||||
Reference in New Issue
Block a user