docs: Update project plan files

This commit is contained in:
2025-12-10 11:58:45 -07:00
parent 5ca8b7e9b4
commit f901aa2242
2 changed files with 75 additions and 26 deletions

View File

@@ -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`)

View File

@@ -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`