Skip to content

Conversation

@bdenham
Copy link
Collaborator

@bdenham bdenham commented Dec 8, 2025

Summary

Improves B2C merchant block documentation with better organization, clearer terminology, and enhanced content for busy, action-oriented merchants.

Key Changes

Sidebar Improvements

  • ✨ New "Setup guides" section for tutorial content (collapsed by default)
  • 📝 Updated terminology: "Targeted Block" → "Personalization" for merchant clarity
  • 🔤 Alphabetized all Commerce blocks for better navigation

Content Updates

  • 🆕 3 new blocks: Account Navigation, Checkout Success, Personalization (quick reference)
  • ✏️ 30 enhanced blocks: Improved descriptions, configurations, and requirements
  • 📚 Tutorial improvements: Removed redundancy, improved clarity in personalization.mdx

Infrastructure

  • 📁 Added enrichment files (descriptions.json, requirements.json)
  • 🔧 Updated generator with latest README improvements
  • 📖 Added REQUIREMENTS-README.md for maintenance workflow

Impact

  • Files changed: 38 (5 infrastructure, 33 B2C blocks)
  • Lines: +2,423 / -1,146
  • Build: ✅ All 375 pages built successfully
  • Links: ✅ All links validated

Testing

Built and verified locally with pnpm build:prod-fast - no errors.

- Add new 'Setup guides' section with Personalization and Product Recommendations tutorials
- Update terminology: 'Targeted Block' → 'Personalization' for merchant clarity
- Add 3 new B2C blocks: Account Navigation, Checkout Success, Personalization (quick reference)
- Enhance all 30 B2C blocks with improved descriptions and configurations
- Add enrichment infrastructure (descriptions.json, requirements.json, REQUIREMENTS-README.md)
- Update generator with latest improvements from README files
- Remove redundancy and improve writing clarity throughout

Changes include:
- 5 infrastructure files (scripts, enrichments, config)
- 33 B2C merchant block files (3 new, 30 modified)
- 1 tutorial file enhanced (personalization.mdx)

Build: ✅ All 375 pages built successfully, all links validated
@bdenham bdenham force-pushed the feature/merchant-blocks-b2c-improvements branch from af2f426 to 0a9e89f Compare December 8, 2025 17:05
@bdenham bdenham self-assigned this Dec 8, 2025
@bdenham bdenham added the major-update Significant original updates to existing content label Dec 8, 2025
@bdenham bdenham requested review from keharper and sirugh December 8, 2025 17:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

major-update Significant original updates to existing content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant