Skip to content

docs: cookbook + PR template - #69

Merged
mmucklo merged 1 commit into
masterfrom
docs/cookbook-and-pr-template
Aug 20, 2026
Merged

docs: cookbook + PR template#69
mmucklo merged 1 commit into
masterfrom
docs/cookbook-and-pr-template

Conversation

@mmucklo

@mmucklo mmucklo commented Aug 20, 2026

Copy link
Copy Markdown
Owner

Two selective docs additions.

docs/cookbook.md

Task-oriented recipes — parse one/many, streaming, RFC presets, failure handling (reason/code/severity), UTF-8/IDN, canonical(), local-part normalizer (Gmail dots/+tag), confusable-domain detection, custom separators, and the legacy array API. Every snippet's output is verified against the actual parser (see the verification run in the commit). Linked from the README's "Other docs" line.

.github/PULL_REQUEST_TEMPLATE.md

Summary / type-of-change / behavior-impact / checklist (tests, cs:check, stan, CHANGELOG, RFC citations for parsing changes).

Docs/tooling only — no code changes. ROADMAP updated (cookbook done; issue templates still open).

- docs/cookbook.md: task-oriented recipes covering parseSingle/parseMultiple,
  streaming, RFC presets, error codes + severity, UTF-8/IDN, canonical(), the
  local-part normalizer, confusable-domain detection, custom separators, and the
  legacy array API. Every snippet's output is verified against the parser.
- .github/PULL_REQUEST_TEMPLATE.md: summary / behavior-impact / checklist
  (tests, cs, stan, changelog, RFC citations).
- README links the cookbook; ROADMAP updated.
@codecov

codecov Bot commented Aug 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.64%. Comparing base (39cf648) to head (96ed56e).

Additional details and impacted files

Impacted file tree graph

@@             Coverage Diff              @@
##             master      #69      +/-   ##
============================================
- Coverage     96.01%   95.64%   -0.38%     
  Complexity      434      434              
============================================
  Files             6        6              
  Lines          1078     1078              
============================================
- Hits           1035     1031       -4     
- Misses           43       47       +4     

see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@mmucklo
mmucklo merged commit 4a136ae into master Aug 20, 2026
14 checks passed
@mmucklo
mmucklo deleted the docs/cookbook-and-pr-template branch August 20, 2026 06:14
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