Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,7 @@ Brief description of changes made.

### Questions and Support
- **Discord**: First become a member at [Intersect](https://www.intersectmbo.org/) and register at [members.intersectmbo.org](https://members.intersectmbo.org/registration) to get voting rights, participate in governance decisions, and access our Discord community's #developer-experience channel. See our [Intersect Membership Guide](docs/intersect-membership-guide.md) for all benefits
- **FAQs**: Check our **[Frequently Asked Questions](docs/faq.md)** for common answers.
- **Issues**: Create an issue for bug reports or feature requests
- **Discussions**: Use GitHub Discussions for questions and ideas

Expand Down
140 changes: 140 additions & 0 deletions website/docs/faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
---
sidebar_position: 999
title: FAQs
description: Common questions and answers for Cardano contributors and developers.
---

# Frequently Asked Questions (FAQs)

Welcome to the Frequently Asked Questions! This section addresses common questions from contributors and developers to help you navigate the ecosystem, understand roles, and get started effectively.

## General Ecosystem

<details>
<summary>Who is who? (Intersect, IOG, CF, Emurgo)</summary>

The ecosystem is decentralized, but there are key entities:
- **Intersect**: The member-based organization responsible for the continuity, governance, and development of the core codebase.
- **IOG (Input Output Global)**: A software research and engineering company that built much of the original core infrastructure.
- **Cardano Foundation (CF)**: A Swiss non-profit focused on brand, adoption, and governance oversight.
- **Emurgo**: The commercial arm driving enterprise adoption and education.
- **Cardano**: The decentralized blockchain protocol itself, owned by no single entity.

</details>

<details>
<summary>How do I join Intersect?</summary>

Joining Intersect is the best way to get involved in governance and decision-making. You can join as an **Associate** (free) or an **Individual Member** ($10/year) to get voting rights.

- **[Read the Complete Membership Guide](./intersect-membership-guide.md)** for a detailed comparison of tiers and benefits.
- **[Register here](https://members.intersectmbo.org/registration)** to sign up immediately.

</details>

<details>
<summary>When are meetings?</summary>

The **Developer Experience Working Group** holds weekly sessions.
- The schedule alternates between morning and evening slots to accommodate global time zones.
- Use the **[Working Group Calendar](./working-group/readme.md)** or check the `#developer-experience` channel in Discord for the specific time and link for this week's meeting.

</details>

<details>
<summary>Where can I ask questions and get help?</summary>

- **Discord**: Join the `#developer-experience` channel in the [Intersect Discord](https://discord.gg/intersect).
- **Stack Exchange**: For technical Q&A: [cardano.stackexchange.com](https://cardano.stackexchange.com).
- **Cardano Forum**: For discussions: [forum.cardano.org](https://forum.cardano.org).

</details>

---

## Roles, Skills & Funding

<details>
<summary>Do I need to know Haskell to contribute?</summary>

**No!** While the core Cardano node is written in Haskell, the ecosystem is vast:
- **TypeScript/JavaScript**: Build with MeshJS, Lucid, or contrib to web tools.
- **Rust**: Used heavily in key libraries (Pallas, Aiken).
- **Go, Python, Java**: Have their own SDKs and wrapper libraries.
- **Non-Code**: We need help with **Documentation**, **Design**, **Governance**, and **Translation**.

</details>

<details>
<summary>Is there funding or payment for contributors?</summary>

Yes, there are several avenues:
- **Paid Open Source Model (POSM)**: A specific framework where Intersect pays maintenance teams to ensure core repositories are maintained and improved. [Read more about POSM](https://www.intersectmbo.org/news/the-paid-open-source-model).
- **Grants**: Intersect and the Cardano Foundation offer grants for specific work.
- **Project Catalyst**: A community voting mechanism where you can propose projects for funding.
- **Bounties**: Occasionally posted for resolving specific issues.
- **Membership**: Being an Intersect member helps you network with teams effectively hiring or looking for partners.

</details>

<details>
<summary>What is a Contributor vs Maintainer?</summary>

- **Contributor**: Anyone who submits code, documentation, or feedback. Open a PR and you are a contributor!
- **Maintainer**: Members with responsibility for the direction/quality of a repo. They review PRs and manage releases.

</details>

---

## Technical Essentials

<details>
<summary>Which Testnet should I use? (Preview vs Preprod)</summary>

- **Preview**: "Fast" testing. Resets occasionally. Good for testing new features quickly.
- **Preprod**: "Slower" testing. Resembles Mainnet parameters. Good for long-term integration testing.
- **SanchoNet**: specifically for testing **Governance** features (CIP-1694).
- **Mainnet**: Production. Real money.

</details>

<details>
<summary>What is a CIP?</summary>

**Cardano Improvement Proposal**. It is a design document providing information to the community, or describing a new feature or process. It is how standards are agreed upon.

</details>

<details>
<summary>How do I set up my development environment?</summary>

- **New Developers**: Check our **[Beginner Guides](./how-to-guide/beginner/)**.
- **Specific Tools**: See the **[Tools section](./resources/tools.md)**.

</details>

---

## Governance & Organization

<details>
<summary>How are decisions made?</summary>

Decisions are made through **Working Groups**, **Committees** (like the Technical Steering Committee), and **Member Voting** on-chain or off-chain depending on the topic.

</details>

<details>
<summary>How do funding, proposals, and repositories relate?</summary>

- **Intersect**: Coordinates governance and development.
- **Funding**: Distributed via grants or Catalyst.
- **Repositories**: Codebases often managed by Intersect or Community, serving as shared infrastructure.

</details>

---

## Still have questions?
If you didn't find your answer here, please ask in the **[Discord Community](https://discord.com/invite/intersect)** or open an issue in this repository.
1 change: 1 addition & 0 deletions website/docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ Our Developer Experience Working Group is running a 12-session program designed

### **Community Support**
- **Discord**: First become a member at [Intersect](https://www.intersectmbo.org/) and register at [members.intersectmbo.org](https://members.intersectmbo.org/registration) to get voting rights and access to our Discord community's #developer-experience channel. See our [Intersect Membership Guide](./intersect-membership-guide.md) to learn about all the benefits including decision-making power in the Cardano ecosystem
- **FAQs**: Check our **[Frequently Asked Questions](./faq.md)** for common answers.
- **Forum**: Ask questions on [Cardano Forum](https://forum.cardano.org)
- **Stack Exchange**: Get technical help at [Cardano Stack Exchange](https://cardano.stackexchange.com)

Expand Down
5 changes: 4 additions & 1 deletion website/docs/how-to-guide/_category_.yml
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
label: How To Guide
label: How To Guide
position: 10
link:
type: generated-index
4 changes: 3 additions & 1 deletion website/docs/resources/_category_.yml
Original file line number Diff line number Diff line change
@@ -1,2 +1,4 @@
label: Resources
position: 1
position: 15
link:
type: generated-index
1 change: 1 addition & 0 deletions website/docs/resources/community.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ There are a variety of community resources in the Cardano ecosystem for anyone l
| What You Need | Where to Go | Link |
|--------------|-------------|------|
| Quick question or real-time help | Discord or Telegram | See Discord section below |
| Common questions & misunderstandings | Frequently Asked Questions | **[Read FAQs](../faq.md)** |
| Detailed problem that needs troubleshooting | Stack Exchange (search first!) | [cardano.stackexchange.com](https://cardano.stackexchange.com) |
| Feedback on tools or docs | GitHub Discussions | [developer-experience](https://github.com/IntersectMBO/developer-experience/discussions) |
| Technical consultation for your project | OSO Project Support | [oso@intersectmbo.org](https://committees.docs.intersectmbo.org/intersect-open-source-committee/about/open-source-office-oso/project-support-services) |
Expand Down
4 changes: 4 additions & 0 deletions website/docs/tutorials/_category_.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
label: Tutorials
position: 20
link:
type: generated-index
5 changes: 5 additions & 0 deletions website/docs/working-group/_category_.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
label: Developer Experience Working Group
position: 30
link:
type: doc
id: readme
3 changes: 2 additions & 1 deletion website/docs/working-group/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,8 @@ Our inaugural quarterly initiative focused on creating a clear entry path for ne
1. First become a member at [Intersect](https://www.intersectmbo.org/) and register at [members.intersectmbo.org](https://members.intersectmbo.org/registration) to get voting rights, participate in governance, and access our Discord community. Learn more in our [Intersect Membership Guide](../intersect-membership-guide.md)
2. Introduce yourself in the Developer Experience channel
3. Attend weekly working group sessions
4. Contribute to documentation and resources
4. **Check the FAQs**: Before asking questions, see if your answer is in our **[Frequently Asked Questions](../faq.md)**.
5. Contribute to documentation and resources

### Session Schedule
- **Cadence**: Weekly sessions
Expand Down
9 changes: 9 additions & 0 deletions website/docusaurus.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,11 @@ const config: Config = {
},
],
},
{
label: "FAQs",
to: "/docs/faq",
position: "left",
},
{
type: "search",
position: "right",
Expand Down Expand Up @@ -195,6 +200,10 @@ const config: Config = {
label: "Tools & APIs",
to: "/docs/resources/tools",
},
{
label: "FAQs",
to: "/docs/faq",
},
],
},
],
Expand Down
Loading