Skip to content

Add Hiro developer tutorials in correct documentation locations#1853

Draft
huth-stacks wants to merge 2 commits intostacks-network:masterfrom
huth-stacks:feat/hiro-developer-tutorials
Draft

Add Hiro developer tutorials in correct documentation locations#1853
huth-stacks wants to merge 2 commits intostacks-network:masterfrom
huth-stacks:feat/hiro-developer-tutorials

Conversation

@huth-stacks
Copy link
Collaborator

@huth-stacks huth-stacks commented Mar 24, 2026

Summary

  • Faithfully migrates 4 Hiro developer guides to their correct IA locations
  • 3 tutorials → tutorials/ (multi-step educational walkthroughs)
  • 1 recipe → cookbook/stacks.js/ (short practical guide)
  • All content preserved verbatim from Hiro source - no truncation

Files Added

  • docs/tutorials/build-an-nft-marketplace.md - Complete NFT marketplace tutorial (20 code blocks, full intro + explanatory prose)
  • docs/tutorials/build-a-decentralized-kickstarter.md - Kickstarter tutorial (with upstream content mismatch warning - see note below)
  • docs/tutorials/no-loss-lottery.md - No-loss lottery tutorial with complete testing section (14 code blocks)
  • docs/cookbook/stacks.js/using-clarity-values.md - Clarity values recipe with full inline code comments

Files Modified

  • docs/tutorials/SUMMARY.md - Added "Hiro Guides" section with 3 entries
  • docs/cookbook/SUMMARY.md - Added Using Clarity Values under Stacks.js

Upstream Content Mismatch Note

The Hiro source file build-a-decentralized-kickstarter.mdx has the title "Build a decentralized Kickstarter" but its body content is identical to the NFT marketplace guide. This is a bug in the upstream Hiro docs, not our error. Migrated faithfully with a warning callout.

Reviewer Feedback Addressed

  • the reviewer "Claude punted on translating this entirely" (Kickstarter) → Fully migrated from source (with upstream mismatch noted)
  • the reviewer "truncates the intro" (NFT marketplace) → Full multi-paragraph intro preserved
  • the reviewer "Claude got lazy with the summary" (no-loss lottery) → All explanatory prose + testing section preserved
  • the reviewer "Intro is truncated" (Clarity values) → Full intro with all code comments preserved
  • the reviewer "All four of these guides probably belong in a different location than Build" → Relocated to tutorials/ and cookbook/

Verification

All code block counts match Hiro source exactly. All line counts within 10% tolerance.

Context

PR 5 of 7 decomposing the Hiro docs migration (#1847). Independent of PRs 2-4.

Test plan

  • Verify code block counts match source (20, 20, 14, 2)
  • Verify no-loss lottery testing section is complete
  • Verify NFT marketplace full intro is present
  • Verify SUMMARY.md entries point to correct files

🤖 Generated with Claude Code

Faithfully migrates 4 Hiro guides to their proper locations:
- NFT Marketplace, Decentralized Kickstarter, No-Loss Lottery → tutorials/
- Using Clarity Values → cookbook/stacks.js/

All content preserved verbatim from Hiro source including full
introductions, explanatory prose, code examples, and testing sections.
The Kickstarter guide (previously a placeholder stub) is now fully
migrated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@CLAassistant
Copy link

CLAassistant commented Mar 24, 2026

CLA assistant check
All committers have signed the CLA.

The Hiro source file build-a-decentralized-kickstarter.mdx has the
title "Build a decentralized Kickstarter" but its body is identical
to the NFT marketplace guide. Rather than ship duplicate content,
removing it until the upstream source is corrected.

Co-Authored-By: Claude Opus 4.6 (1M context) <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.

2 participants