COMDOX-1681: Rewrite product-details merchant page for authors

[bdenham]

Summary

Rewrites the product-details merchant block page from a 72-line stub into a beginner-friendly author guide. The new page explains where the block already lives in the default boilerplate, what shoppers see, when to use it, the common authoring tasks an author can do without code, the corrected default-sku configuration, and where to hand off to a developer. It serves as the pilot template for the rest of the B2C and B2B merchant block pages tracked by COMDOX-1681.

Changes

• Replace the short intro with a description that names the block, lists what it renders, and tells authors which audience this page is written for.
• Add "Where this block lives in your default boilerplate" so authors understand they edit /products/default rather than adding the block from scratch.
• Add "What shoppers see" with a list of UI regions and cross-links to the developer container pages under /dropins/product-details/.
• Add "When to use this block" covering the standard PDP, marketing pages, and multiple instances on one page.
• Add "Common authoring tasks" with <Steps> for previewing the template page, featuring a specific product, setting the SKU through page metadata, adjusting section styling, and adding related blocks.
• Correct the Configuration section for default-sku, including the SKU resolution chain in scripts/commerce.js and the itemUid / optionsUIDs URL parameters consumed by the block.
• Add "Customize beyond authoring" with links into the drop-in overview, containers, slots, events, and tutorials so the page hands off cleanly to developer docs.
• Add "Verify and publish" steps and a short "Common failure modes" list for troubleshooting.

Testing

• Manual review against the project's beginner-audience, writing-style, and no-bold rules.
• Internal links resolve to existing pages in this repo (/dropins/product-details/containers/*, /merchants/blocks/b2b/, /dropins/product-details/).
• default-sku behavior verified against the live boilerplate (scripts/commerce.js and blocks/product-details/product-details.js on hlxsites/aem-boilerplate-commerce main).

JIRA

COMDOX-1681

Made with Cursor