docs: Update project plan files
This commit is contained in:
@@ -2,6 +2,16 @@
|
||||
|
||||
**Last Updated**: 2025-12-10
|
||||
|
||||
## Recently Completed
|
||||
|
||||
### v1.3.0 - Microformats2 Compliance and Tags (Complete)
|
||||
- Tag/Category system with database schema
|
||||
- p-category microformats2 markup
|
||||
- h-feed required properties (name, author, url)
|
||||
- Author h-card with photo and bio
|
||||
- u-photo placement outside e-content
|
||||
- mf2py validation test suite
|
||||
|
||||
## Priority Levels
|
||||
|
||||
- **Critical** - Items that break existing functionality
|
||||
@@ -19,14 +29,6 @@
|
||||
|
||||
## High
|
||||
|
||||
### 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
|
||||
|
||||
### Enhanced Feed Media Support
|
||||
- Multiple image sizes/thumbnails (150px, 320px, 640px, 1280px)
|
||||
- Full Media RSS implementation (media:group, all attributes)
|
||||
@@ -34,17 +36,16 @@
|
||||
- ATOM enclosure links for all media
|
||||
- See: ADR-059
|
||||
|
||||
### Tag/Category System
|
||||
- Database schema for tags
|
||||
- Tag-based filtering
|
||||
- Tag clouds
|
||||
- Category RSS/ATOM/JSON feeds
|
||||
- p-category microformats2 support
|
||||
|
||||
---
|
||||
|
||||
## Medium
|
||||
|
||||
### Tag Enhancements (v1.3.0 Follow-up)
|
||||
- Tag pagination on archive pages (when note count exceeds threshold)
|
||||
- Tag autocomplete in admin interface
|
||||
- Tag-filtered feeds (e.g., `/feed.rss?tag=python`, `/tags/python/feed.rss`)
|
||||
- Fix: Empty tag field in admin should remove all tags (currently may leave unchanged)
|
||||
|
||||
### Tag-Filtered Feeds
|
||||
- Filter feeds by tag (e.g., `/feed.rss?tag=python`)
|
||||
- Dedicated tag feed URLs (e.g., `/tags/python/feed.rss`)
|
||||
|
||||
@@ -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