Contributor Training: Contributing to ddev.com

Here’s our October 9, 2025 Contributor Training on contributing to ddev.com:

Key Topics

Quick Edits via GitHub (4:11)

The easiest way to fix errors or update content is to click the pencil icon on any blog post. This takes you directly to GitHub where you can make edits and create a pull request—all without checking out the repository locally.

Writing Blog Posts (12:53)

Community blog posts are encouraged! Share your expertise, workarounds, and solutions. Start by opening an issue to discuss your blog post idea with the community. Then copy a similar blog post from src/content/blog and adapt it with your content.

Author Profiles (18:00)

Add your author profile to src/content/authors/ with your name, first name, and optional avatar URL. The avatar can be from Gravatar, the image directory, or your own site.

Local Preview (26:46)

Run ddev start to preview your changes locally with hot module reloading at the URL shown in the startup output.

Quality Checks (35:15)

Every pull request automatically runs:

• Prettier for code formatting
• Textlint for content consistency and terminology

The linter rules are defined in .textlintrc and enforce consistent usage of terms like “ARM64”, “Bash”, and “phpMyAdmin”.

Preview Deployments (32:15)

Each pull request automatically creates a preview deployment on Cloudflare Pages, allowing you and reviewers to see exactly how the changes will look on the live site.

Resources

• Presentation Slides
• ddev.com Repository
• DDEV Website For Contributors blog post

Contributions welcome!

Your suggestions to improve this blog are welcome. You can do a PR to this blog adding your techniques. Info and a training session on how to do a PR to anything in ddev.com is at DDEV Website For Contributors.

Follow the DDEV Newsletter for information about upcoming user and contributor training sessions.

Claude Code did almost all of the collation of the information in this blog from the YouTube video and the presentation materials.