Skip to content

Commit 93e641b

Browse files
author
danbaruka
committed
docs(kickoff): restore 01-kickoff-orientation from upstream
1 parent bf4139b commit 93e641b

2 files changed

Lines changed: 244 additions & 246 deletions

File tree

‎website/docs/working-group/q1-2025/sessions/01-kickoff-orientation/directive-kickoff.md‎

Lines changed: 234 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,234 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Directive: Kickoff & Orientation
6+
7+
Welcome to the Cardano ecosystem! This guide provides a comprehensive map of where to find essential resources, repositories, documentation, tooling, and support channels to help you navigate and contribute effectively.
8+
9+
## → About Cardano
10+
11+
**Cardano** is a third-generation, proof-of-stake blockchain platform designed for sustainability, scalability, and transparency. Built on peer-reviewed research and evidence-based development, Cardano aims to provide a secure and scalable infrastructure for decentralized applications (dApps), smart contracts, and financial systems.
12+
13+
**Key Characteristics:**
14+
15+
- **Research-Driven**: Every protocol feature undergoes formal specification and peer review
16+
- **Multi-Layered Architecture**: Separates settlement (ADA transactions) from computation (smart contracts)
17+
- **Sustainable**: Energy-efficient Ouroboros proof-of-stake consensus protocol
18+
- **Interoperable**: Designed to work with other blockchains and legacy systems
19+
20+
## → About Intersect
21+
22+
**Intersect** is a member-based organization that serves as the governance and administrative body for Cardano. It facilitates community collaboration, coordinates development efforts, and ensures the long-term sustainability of the Cardano ecosystem.
23+
24+
**Mission**: To empower the Cardano community through transparent governance, coordinated development, and accessible resources for all participants—from beginners to core contributors.
25+
26+
**Key Functions:**
27+
28+
- Facilitating on-chain governance processes
29+
- Coordinating technical working groups and committees
30+
- Managing community resources and development programs
31+
- Supporting developer experience and contributor onboarding
32+
33+
**Why Join as a Developer?** As an Intersect member, you get voting rights on ecosystem decisions, can participate in technical steering committees, access exclusive development updates, and help shape the tools and protocols you build with daily. Individual membership is just $10/year for full governance participation.
34+
35+
---
36+
37+
## ▸ Core Repositories
38+
39+
### Cardano Node & Core Infrastructure
40+
41+
| Repository | Description | Why It Matters |
42+
| ---------------------------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------------- |
43+
| [cardano-node](https://github.com/IntersectMBO/cardano-node) | Core node implementation of Cardano blockchain | The heart of Cardano—handles block production, validation, and network consensus |
44+
| [cardano-cli](https://github.com/IntersectMBO/cardano-node) | Command-line interface for node operations | Essential tool for interacting with the blockchain, creating transactions, and managing keys |
45+
| [cardano-db-sync](https://github.com/IntersectMBO/cardano-db-sync) | Synchronizes Cardano blockchain data to PostgreSQL | Powers explorers and analytics by making blockchain data queryable |
46+
| [ouroboros-network](https://github.com/IntersectMBO/ouroboros-network) | Networking layer for Cardano nodes | Implements the peer-to-peer communication protocol between nodes |
47+
48+
### Smart Contract Development
49+
50+
| Repository | Description | Why It Matters |
51+
| ---------------------------------------------------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------- |
52+
| [plutus](https://github.com/IntersectMBO/plutus) | Plutus smart contract platform and language | The foundation for writing smart contracts on Cardano using Haskell-based languages |
53+
| [plutus-apps](https://github.com/IntersectMBO/plutus-apps) | Off-chain infrastructure and tools for Plutus | Provides tools for building complete dApps, including PAB (Plutus Application Backend) |
54+
| [aiken](https://github.com/aiken-lang/aiken) | Modern smart contract language for Cardano | Alternative to Plutus—focuses on developer experience with simpler syntax |
55+
| [cardano-transaction-lib](https://github.com/Plutonomicon/cardano-transaction-lib) | PureScript library for building transactions | Enables frontend developers to build Cardano dApps in TypeScript/JavaScript environments |
56+
57+
### Developer Tools & SDKs
58+
59+
| Repository | Description | Why It Matters |
60+
| -------------------------------------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------- |
61+
| [cardano-serialization-lib](https://github.com/Emurgo/cardano-serialization-lib) | Library for serialization & deserialization | Essential for building wallets and dApps—handles low-level transaction construction |
62+
| [cardano-wallet](https://github.com/cardano-foundation/cardano-wallet) | HTTP REST API for wallet operations | Simplifies wallet backend development with a high-level API |
63+
| [pycardano](https://github.com/Python-Cardano/pycardano) | Python library for Cardano | Enables Python developers to interact with Cardano blockchain |
64+
| [cardanocli-js](https://github.com/Berry-Pool/cardanocli-js) | JavaScript wrapper for cardano-cli | Makes CLI operations accessible from Node.js applications |
65+
66+
### Testing & Quality Assurance
67+
68+
| Repository | Description | Why It Matters |
69+
| -------------------------------------------------------------------------------- | --------------------------------- | ----------------------------------------------------------- |
70+
| [cardano-node-tests](https://github.com/IntersectMBO/cardano-node-tests) | End-to-end tests for cardano-node | Ensures node reliability and catches regressions |
71+
| [plutus-pioneer-program](https://github.com/IntersectMBO/plutus-pioneer-program) | Educational materials for Plutus | Learn smart contract development through structured lessons |
72+
73+
---
74+
75+
## ▸ Documentation Resources
76+
77+
### Official Documentation
78+
79+
| Resource | Content | Access |
80+
| ---------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------- |
81+
| **Cardano Developer Portal** | Comprehensive guides, tutorials, and API references | [developers.cardano.org](https://developers.cardano.org) |
82+
| **Cardano Docs** | Protocol specifications, architecture, and technical details | [docs.cardano.org](https://docs.cardano.org) |
83+
| **Plutus Documentation** | Smart contract language reference and examples | [plutus.readthedocs.io](https://plutus.readthedocs.io) |
84+
| **CIPs (Cardano Improvement Proposals)** | Standards and protocol improvements | [github.com/cardano-foundation/CIPs](https://github.com/cardano-foundation/CIPs) |
85+
| **Intersect Knowledge Base** | Governance processes and organizational structure | [docs.intersectmbo.org](https://docs.intersectmbo.org) |
86+
87+
### Learning Paths
88+
89+
- **Beginner**: Start with [Cardano Developer Portal](https://developers.cardano.org) → Complete basic tutorials → Explore testnet
90+
- **Smart Contract Developer**: Learn [Plutus Fundamentals](https://plutus.readthedocs.io) → Try [Aiken](https://aiken-lang.org/getting-started) → Build sample dApps
91+
- **Infrastructure/Node Operator**: Study [Node Setup Guide](https://developers.cardano.org/docs/operate-a-stake-pool/) → Understand consensus → Run testnet node
92+
- **Frontend Developer**: Explore [Cardano Transaction Lib](https://github.com/Plutonomicon/cardano-transaction-lib) → Integrate with wallets → Build user interfaces
93+
94+
---
95+
96+
## ▸ Essential Tooling
97+
98+
### Development Environments
99+
100+
| Tool | Purpose | Installation |
101+
| ----------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------- |
102+
| **Docker Images** | Pre-configured Cardano environments | `docker pull inputoutput/cardano-node` |
103+
| **Daedalus** | Full node wallet for testing | [daedaluswallet.io](https://daedaluswallet.io) |
104+
| **cardano-node** | Run local node for development | [Installation Guide](https://developers.cardano.org/docs/get-started/installing-cardano-node) |
105+
| **cardano-cli** | Command-line interaction with blockchain | Included with cardano-node |
106+
107+
### Smart Contract Tooling
108+
109+
| Tool | Purpose | Get Started |
110+
| --------------------- | ---------------------------------------- | ---------------------------------------------------------------------- |
111+
| **Aiken** | Modern smart contract development | `cargo install aiken` → [aiken-lang.org](https://aiken-lang.org) |
112+
| **Plutus Playground** | Browser-based Plutus IDE | [playground.plutus.iohkdev.io](https://playground.plutus.iohkdev.io) |
113+
| **Opshin** | Python-based smart contracts | [github.com/OpShin/opshin](https://github.com/OpShin/opshin) |
114+
| **Helios** | JavaScript-based smart contract language | [github.com/Hyperion-BT/Helios](https://github.com/Hyperion-BT/Helios) |
115+
116+
### Wallet Integration
117+
118+
| Wallet | Type | Integration |
119+
| -------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
120+
| **Lace** | Light wallet by IOG | [lace.io](https://lace.io) |
121+
| **Eternl** | Multi-platform wallet | [eternl.io](https://eternl.io) |
122+
| **Wallet Connector** | dApp integration library | [github.com/cardano-foundation/cardano-connect-with-wallet](https://github.com/cardano-foundation/cardano-connect-with-wallet) |
123+
124+
### Block Explorers & APIs
125+
126+
| Service | Purpose | URL |
127+
| -------------------- | -------------------------------- | ---------------------------------------------------- |
128+
| **Cardano Explorer** | Blockchain explorer | [explorer.cardano.org](https://explorer.cardano.org) |
129+
| **CardanoScan** | Advanced explorer with analytics | [cardanoscan.io](https://cardanoscan.io) |
130+
| **Blockfrost** | RESTful API service | [blockfrost.io](https://blockfrost.io) |
131+
| **Koios** | Decentralized API | [koios.rest](https://koios.rest) |
132+
133+
---
134+
135+
## ▸ Community & Support
136+
137+
### Communication Channels
138+
139+
| Platform | Purpose | Link |
140+
| -------------------------- | ------------------------------------------- | -------------------------------------------------------------- |
141+
| **Cardano Forum** | Long-form discussions and proposals | [forum.cardano.org](https://forum.cardano.org) |
142+
| **Intersect Discord** | Real-time community chat and working groups | First become a member at [Intersect](https://www.intersectmbo.org/) and register at [members.intersectmbo.org](https://members.intersectmbo.org/registration) to get Discord access |
143+
| **IOG Technical Discord** | Developer-focused technical support | [discord.gg/inputoutput](https://discord.gg/inputoutput) |
144+
| **Cardano Stack Exchange** | Q&A for developers | [cardano.stackexchange.com](https://cardano.stackexchange.com) |
145+
| **Reddit** | Community discussions | [r/cardano](https://reddit.com/r/cardano) |
146+
147+
### Working Groups & Committees
148+
149+
Intersect facilitates various working groups focused on specific areas:
150+
151+
- **Technical Steering Committee**: Oversees technical direction and standards
152+
- **Developer Experience Working Group**: Improves tools and documentation
153+
- **Smart Contract Working Group**: Advances smart contract capabilities
154+
- **Security Working Group**: Ensures ecosystem security practices
155+
156+
_Join working groups through the [Intersect portal](https://intersectmbo.org)_
157+
158+
### Getting Help
159+
160+
1. **Technical Issues**: Search [Cardano Stack Exchange](https://cardano.stackexchange.com) → Ask in Discord (after becoming an Intersect member) → File GitHub issues
161+
2. **General Questions**: Check documentation first → Ask in community forums → Join Discord channels (after becoming an Intersect member)
162+
3. **Bug Reports**: File detailed issues in relevant GitHub repositories with reproduction steps
163+
4. **Feature Requests**: Submit CIPs (Cardano Improvement Proposals) for protocol changes
164+
165+
---
166+
167+
## ▸ Getting Started Checklist
168+
169+
### For New Contributors
170+
171+
- [ ] Join [Intersect](https://intersectmbo.org) as a member to get voting rights and participate in governance ($10/year for individual membership, or free Associate tier)
172+
- [ ] Set up local development environment (Node + CLI)
173+
- [ ] Complete a tutorial from [developers.cardano.org](https://developers.cardano.org)
174+
- [ ] After becoming an Intersect member, join relevant Discord channels and introduce yourself
175+
- [ ] Explore testnet with test ADA from [faucet](https://docs.cardano.org/cardano-testnet/tools/faucet)
176+
- [ ] Read [CONTRIBUTING.md](https://github.com/IntersectMBO/developer-experience/blob/main/CONTRIBUTING.md) guidelines
177+
- [ ] Make your first contribution (documentation, code, or testing)
178+
179+
### For dApp Developers
180+
181+
- [ ] Choose your tech stack (Plutus/Aiken/Helios for on-chain, CTL/JavaScript for off-chain)
182+
- [ ] Set up wallet for testnet testing
183+
- [ ] Explore sample projects and templates
184+
- [ ] Integrate Blockfrost or Koios API for blockchain queries
185+
- [ ] Build and deploy to testnet
186+
- [ ] Get community feedback before mainnet deployment
187+
188+
### For Node Operators
189+
190+
- [ ] Review [stake pool operator documentation](https://developers.cardano.org/docs/operate-a-stake-pool/)
191+
- [ ] Understand hardware and network requirements
192+
- [ ] Set up monitoring and alerting
193+
- [ ] Join [SPO Discord channels](https://discord.gg/cardano-community) for peer support
194+
- [ ] Test setup on testnet before mainnet
195+
196+
---
197+
198+
## ▸ Quick Reference Links
199+
200+
### Essential GitHub Organizations
201+
202+
- [IntersectMBO](https://github.com/IntersectMBO) - Core protocol development
203+
- [cardano-foundation](https://github.com/cardano-foundation) - Foundation projects
204+
- [Emurgo](https://github.com/Emurgo) - Commercial ecosystem tools
205+
206+
### Standards & Specifications
207+
208+
- [CIPs Repository](https://github.com/cardano-foundation/CIPs) - Improvement proposals
209+
- [Plutus Core Specification](https://github.com/IntersectMBO/plutus#specifications) - Smart contract VM specs
210+
- [Formal Ledger Specifications](https://github.com/IntersectMBO/cardano-ledger#formal-specifications) - Protocol rules
211+
212+
### Research Papers
213+
214+
- [IOHK Research Library](https://iohk.io/en/research/library/) - Peer-reviewed papers
215+
- [Ouroboros Protocol](https://iohk.io/en/research/library/papers/ouroboros-a-provably-secure-proof-of-stake-blockchain-protocol/) - Consensus mechanism
216+
217+
---
218+
219+
## ▸ Next Steps
220+
221+
Now that you have your bearings, choose your path:
222+
223+
1. **Learn More**: Deep dive into documentation relevant to your interests
224+
2. **Build Something**: Start with a simple project on testnet
225+
3. **Get Involved**: Join working groups or contribute to existing projects
226+
4. **Connect**: Introduce yourself in community channels
227+
228+
**Remember**: The Cardano community values quality, research, and collaboration. Don't hesitate to ask questions—everyone started as a beginner!
229+
230+
---
231+
232+
_Last Updated: October 2025 | Maintained by Intersect Developer Advocate_
233+
234+
_Last updated: October 2025_

0 commit comments

Comments
 (0)