Skip to content

fix: modernize distribution metadata and documentation#32

Draft
toddr-bot wants to merge 2 commits intocpan-authors:mainfrom
toddr-bot:koan.toddr.bot/dist-quality-improvements
Draft

fix: modernize distribution metadata and documentation#32
toddr-bot wants to merge 2 commits intocpan-authors:mainfrom
toddr-bot:koan.toddr.bot/dist-quality-improvements

Conversation

@toddr-bot
Copy link
Copy Markdown
Collaborator

@toddr-bot toddr-bot commented Mar 28, 2026

What

Modernize Makefile.PL metadata for CPAN indexing and replace stale POD with a comprehensive supported syntax reference.

Why

The META_MERGE was using v1 format without provides, missing the LICENSE parameter, and the POD contained 150 lines of 2004-era changelog duplicating the Changes file while lacking any mention of the 20+ Perl 5.10-5.28+ constructs the parser now supports.

How

  • Makefile.PL: Add LICENSE => 'perl_5', upgrade to META spec v2 with proper nested resources, add provides using dynamic version extraction (MM->parse_version)
  • POD: New SUPPORTED SYNTAX section organized by Perl version (5.6+ through 5.28+), replace inline HISTORY with pointer to Changes, modernize CAVEATS, update AUTHOR/COPYRIGHT sections
  • README: Regenerated from updated POD

Testing

All 1155 tests pass. POD validates clean with podchecker. META output verified via MYMETA.json inspection.

🤖 Generated with Claude Code


Quality Report

Changes: 3 files changed, 188 insertions(+), 404 deletions(-)

Code scan: clean

Tests: passed (OK)

Branch hygiene: clean

Generated by Kōan post-mission quality pipeline

toddr-bot and others added 2 commits March 28, 2026 23:50
- Add LICENSE => 'perl_5' parameter
- Upgrade META_MERGE to spec version 2
- Add provides section with dynamic version extraction
- Use proper nested resource format (repository, bugtracker)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add comprehensive SUPPORTED SYNTAX section documenting all handled
  Perl regex constructs from 5.6 through 5.28+
- Remove 150-line inline HISTORY section (duplicated Changes file)
- Update CAVEATS: remove stale "email me" text, add visual() caveat
- Add current maintainer to AUTHOR section
- Rename COPYRIGHT to COPYRIGHT AND LICENSE
- Regenerate README from updated POD

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant