Documentation, guides, and working-group resources for developers building on Cardano. This repository powers the Developer Experience portal and hosts session materials for the Intersect MBO Developer Experience Working Group.
The Developer Experience (DevEx) Working Group is a community of Developer Advocates from Intersect MBO focused on making Cardano more accessible, efficient, and rewarding to build on.
We identify pain points in the ecosystem, improve tooling and documentation, and run collaborative workshops for developers at every level.
Key focus areas:
| Area | What we work on |
|---|---|
| Onboarding & documentation | Guides, tutorials, and structured learning paths |
| Tooling & workflows | Dev environments, SDKs, and developer tooling |
| Community & collaboration | Working-group sessions, feedback loops, knowledge sharing |
| Inclusive onboarding | Multi-language support and the Developer Thriving Framework |
Live site: devex.intersectmbo.org
Connect with the current cohort for mentorship, session planning, or contribution guidance.
| Advocate | Links | Schedule a call |
|---|---|---|
| Uche | LinkedIn · Discord: @obate |
Book a call |
| Emmanuel | LinkedIn · X · Discord: @emmanueltyty |
Book a call |
| Dan | LinkedIn · X · Discord: @danamphred |
Book a call |
| Harun | LinkedIn · Discord: @wesh09 |
Book a call |
| Advocate | Interview | Discord | |
|---|---|---|---|
| Alex | Watch | Profile | alexeusgr |
| Bernand | Watch | Profile | wims5274 |
| Suganya | Watch | Profile | suganya1607 |
| Udai | Watch | Profile | thecoder0001 |
Get the documentation site running locally in under 5 minutes:
# 1. Clone the repository
git clone https://github.com/IntersectMBO/developer-experience.git
cd developer-experience/website
# 2. Install dependencies (Node.js 20+ required)
npm install
# 3. Start the development server with hot reload
npm run start:devOpen http://localhost:3000 in your browser. Edits to files under website/docs/ reload automatically.
| Requirement | Version |
|---|---|
| Node.js | 20 or higher |
| npm | Bundled with Node.js |
| Git | Any recent version |
See the Contributing Guide for full setup, development, and submission instructions.
Documentation lives in website/docs/. Create or edit Markdown (.md) or MDX (.mdx) files:
---
sidebar_position: 2
---
# My New Guide
Brief introduction for developers.
## Prerequisites
- A Cardano wallet
- Node.js 20+
## Steps
1. Install the CLI tool.
2. Run your first command.Session materials follow a quarter-based layout under website/docs/working-group/sessions/:
website/docs/working-group/sessions/
└── q2-2026/
└── 18-my-session/
├── _category_.json
├── session-notes/
│ └── readme.md
└── session-resources/
└── readme.md
See existing sessions (for example q4-2025/01-kickoff-orientation/) for the established pattern.
developer-experience/
├── website/ # Docusaurus documentation site
│ ├── docs/ # Documentation content (Markdown / MDX)
│ │ ├── getting-started.md # Main onboarding guide
│ │ ├── how-to-guide/ # Beginner, intermediate, and advanced guides
│ │ ├── tutorials/ # Hands-on tutorials
│ │ ├── resources/ # Tools, repos, and community links
│ │ └── working-group/ # DevEx WG session materials
│ ├── src/ # React components and custom theme
│ ├── static/ # Static assets (images, CNAME)
│ └── docusaurus.config.ts # Site configuration
├── DA Milestones/ # Developer Advocate milestone reports
├── scripts/ # Utility scripts (e.g. changelog)
├── CONTRIBUTING.md # Contribution guidelines
├── CODE-OF-CONDUCT.md # Community standards
└── LICENSE # Apache 2.0
| Resource | Description |
|---|---|
| Getting Started | Onboarding paths for new Cardano developers |
| How-To Guides | Step-by-step guides by skill level |
| Working Group | Session plans, notes, and recordings |
| FAQ | Answers to common questions |
| Intersect Membership Guide | How to join Intersect and access Discord |
- Meetings — Join weekly DevEx working-group sessions via the Intersect Event calendar.
- GitHub — Report problems in Issues, propose fixes in Pull Requests, and join Discussions.
- Intersect membership — Become a member to participate in governance and access the Discord community.
- Discord — DevEx WG channel: #developer-experience.
We welcome contributions from all skill levels. Before you start:
- Read CONTRIBUTING.md for the full workflow.
- Review the Code of Conduct.
- Check existing issues before opening a new one.
- Open an issue to discuss significant changes, then submit a pull request linked to that issue.
Typical contributions include documentation fixes, new guides, code examples, and working-group session materials.
| Channel | Link |
|---|---|
| GitHub Discussions | developer-experience/discussions |
| Discord (OSC Working Groups) | Join channel |
| oso@intersectmbo.org |
This working group is community-driven and supported by Intersect MBO. We welcome contributions from all skill levels and backgrounds.
Disclaimer: Content reflects community efforts and may evolve as the Cardano ecosystem grows. Report outdated information via GitHub Issues.
This project is licensed under the Apache License 2.0.