IntersectMBO / IntersectMBO/developer-experience

Update code samples so tutorials build and run

Open
#301 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
13
Forks
22
Avg merge
18h 40m
Merged PRs (30d)
11

Description

### Discussed in https://github.com/IntersectMBO/developer-experience/discussions/276

Originally posted by **IanoNjuguna** August 13, 2026
Some of our tutorials and session notes need to be updated, i.e. commands that don't work, packages that no longer exist, and dead links.

Work will happen on the `fix/tutorial-code-samples` branch and ship as one PR.

## Checklist: tutorials to verify

Go through each file, follow the steps like a new user would, and tick it off
when it works (or once it's fixed).

**Tutorials**
- [ ] `website/docs/tutorials/local-cardano-payment-detector.md`

**Guides**
- [ ] `website/docs/guides/blaze-yaci-store-integration.md`

**How-to guides**
- [ ] `website/docs/how-to-guide/advanced/cardano-api.md`
- [ ] `website/docs/how-to-guide/advanced/yaci-devkit.mdx`
- [ ] `website/docs/how-to-guide/advanced/go-core-contributor.md`
- [ ] `website/docs/how-to-guide/advanced/rust-core-contributor.md`
- [ ] `website/docs/how-to-guide/beginner/address.md`
- [ ] `website/docs/how-to-guide/beginner/inputsandoutputs.md`

**Working group — Q4 2025**
- [ ] `website/docs/working-group/sessions/q4-2025/06-repo-walkthrough/sesion-notes/readme.md`

**Working group — Q1 2026**
- [ ] `website/docs/working-group/sessions/q1-2026/08-open-clinic-1/session-1/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q1-2026/08-open-clinic-1/session-1/session-resources/readme.md`
- [ ] `website/docs/working-group/sessions/q1-2026/10-wallet-integration/Session-2/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q1-2026/10-wallet-integration/Session-2/session-resources/readme.md`
- [ ] `website/docs/working-group/sessions/q1-2026/12-cardano-developer-pathway/session-notes/readme.mdx`
- [ ] `website/docs/working-group/sessions/q1-2026/14-CIP-68 NFT-Standard/session-notes/readme.md`

**Working group — Q2 2026**
- [ ] `website/docs/working-group/sessions/q2-2026/14-sdk-repo-walkthrough/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q2-2026/15-dapp-architecture-demo/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q2-2026/16-ui-smart-contract-interaction/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q2-2026/17-default-developer-environment/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q2-2026/18-cardano-mcp-server/session-notes/readme.md`
- [ ] `website/docs/working-group/sessions/q2-2026/19-one-api-call-blockfrost/session-notes/readme.md`

Contributor guide

Open the contributing guide

Research direction

Start from the listed files on the fix/tutorial-code-samples branch and follow each tutorial, guide, and session note as a new user. Check commands, packages, links, and build steps in every file, then mark each checklist item complete once its instructions work and the documentation build succeeds.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.