Contributing to Dapr on Dapr Docs

Contribution overview

Mon, 01 Jan 0001 00:00:00 +0000

Thank you for your interest in Dapr! This document provides the guidelines for how to contribute to the Dapr project through issues and pull requests. Contributions can also come in additional ways such as engaging with the community in community calls, commenting on issues or pull requests, and more.

See the Dapr community repository for more information on community engagement and community membership.

Dapr Repository Index

Below is a list of repositories under the Dapr organization where you can contribute:

Giving a presentation on Dapr

Mon, 01 Jan 0001 00:00:00 +0000

We encourage community members to give presentations on Dapr. To get you started quickly, we offer three PowerPoint files:

dapr-slidedeck.pptx, this is a 150+ page slide deck and contains: an overview of Dapr, all of its building block APIs, cross-cutting concerns, hosting options, and assets to create your own architecture diagrams.
dapr-workflow-slidedeck.pptx, this is a dedicated slide deck about Dapr Workflow and contains: durable execution concept, workflow authoring, workflow patterns, workflow management, and challenges & tips.
dapr-agents-slidedeck.pptx, this is a dedicated slide deck about Dapr Agents and contains: AI agents explanation, Dapr Agent types, multi-agent systems, and agentic patterns.

There is a downloadable zip file that contains all slide decks.

Dapr Roadmap

Mon, 01 Jan 0001 00:00:00 +0000

See this document to view the Dapr project’s roadmap.

Contributing with GitHub Codespaces

Mon, 01 Jan 0001 00:00:00 +0000

GitHub Codespaces is the easiest way to get up and running for contributing to a Dapr repo. In as little as a single click, you can have an environment with all of the prerequisites ready to go in your browser.

Features

Click and Run: Get a dedicated and sandboxed environment with all of the required frameworks and packages ready to go.
Usage-based Billing: Only pay for the time you spend developing in the Codespaces. Environments are spun down automatically when not in use.
Portable: Run in your browser or in Visual Studio Code, or connect to it using SSH.

Open a Dapr repo in a Codespace

To open a Dapr repository in a Codespace, select “Code” from the repo homepage and “Open with Codespaces”:

Dapr bot reference

Mon, 01 Jan 0001 00:00:00 +0000

Dapr bot is triggered by a list of commands that helps with common tasks in the Dapr organization. It is set up individually for each repository (example) and can be configured to run on specific events. Below is a list of commands and the list of repositories they are implemented on.

Command reference

Command	Target	Description	Who can use	Repository
`/assign`	Issue	Assigns an issue to a user or group of users	Anyone	`dapr`, `docs`, `quickstarts`, `cli`, `components-contrib`, `go-sdk`, `js-sdk`, `java-sdk`, `python-sdk`, `dotnet-sdk`, `rust-sdk`
`/ok-to-test`	Pull request	`dapr`: trigger end to end tests `components-contrib`: trigger conformance and certification tests	Users listed in the bot	`dapr`, `components-contrib`
`/ok-to-perf`	Pull request	Trigger performance tests.	Users listed in the bot	`dapr`
`/make-me-laugh`	Issue or pull request	Posts a random joke	Users listed in the bot	`dapr`, `components-contrib`

Label reference

You can query issues created by the Dapr bot by using the created-by/dapr-bot label (query).

Contributing to Dapr Agents

Mon, 01 Jan 0001 00:00:00 +0000

When contributing to Dapr Agents, the following rules and best-practices should be followed.

Examples

The examples directory contains code samples for users to run to try out specific functionality of the various Dapr Agents packages and extensions. When writing new and updated samples keep in mind:

All examples should be runnable on Windows, Linux, and MacOS. While Python code is consistent among operating systems, any pre/post example commands should provide options through codetabs
Contain steps to download/install any required pre-requisites. Someone coming in with a fresh OS install should be able to start on the example and complete it without an error. Links to external download pages are fine.

Dependencies

This project uses modern Python packaging with pyproject.toml. Dependencies are managed as follows: