Contributing to dstack

Contributing to dstack goes beyond code—it includes documentation improvements, security research, educational content, and community building. We recognize that expertise comes in many forms, and every contribution strengthens the ecosystem. To get started, follow these straightforward steps to contribute via GitHub:

Fork & Star Repository

  • ⭐️ Star the repository: dstack repository
  • 🍴 Fork the repository to your GitHub account.

Creating a Pull Request (PR)

  1. Clone the forked repo:
   git clone https://github.com/YOUR_USERNAME/dstack.git
   cd dstack
  1. Create a branch for your changes:
    git checkout -b fix/your-issue-description
    
  2. Make your changes and commit:
    git add .
    git commit -m "fix: short description of changes"
    
  3. Push your branch:
    git push origin fix/your-issue-description
    
  4. Open a PR on the dstack repository from your branch. Reference the relevant issue clearly in your PR description.

PR Template

Use this simple template for your PR description:
### Description
Brief summary of the change.

### Related Issue
Link or number of the issue (e.g., closes #123).

### Type of Change
- [ ] Bug fix
- [ ] Enhancement
- [ ] Documentation update

### Additional Context
Any additional information here.

Creating Issues

  • Clearly state the problem or enhancement.
  • Label appropriately: bug, enhancement, or documentation.
  • Provide steps to reproduce if it’s a bug.
Please allow 1-3 days for responses from core contributors.