The .NET Blog is a community-driven publication where developers share insights, tutorials, and stories about .NET, Azure, AI, and cloud-native development. We welcome contributions from developers of all levels — whether you’re writing your first technical post or you’re a seasoned speaker.

How to Join

Everything lives on GitHub and follows a pull-request workflow. Here’s how to get started:

1. Fork the Repository

Head to github.com/thedotnetblog/blog and fork it to your GitHub account.

2. Create Your Author Profile

If this is your first contribution, add yourself as an author by creating a folder at content/authors/your-username/ with an index.md file:

---
title: "Your Name"
id: "your-username"
role: "Your role or title"
bio: "A short bio about yourself."
avatar: "/img/authors/your-avatar.jpg"
socials:
  - platform: "GitHub"
    url: "https://github.com/your-username"
  - platform: "Twitter"
    url: "https://x.com/your-username"
---

Add your avatar image (square, at least 200×200px) to static/img/authors/.

3. Write Your Post

Create a new folder at content/posts/your-username/your-post-slug/ and add an index.md file:

---
title: "Your Post Title"
date: 2025-01-01
author: "your-username"
description: "A one-sentence description of your post."
tags: ["dotnet", "azure"]
---

Your post content in Markdown...

4. Open a Pull Request

Push your changes to your fork and open a pull request against the main branch. Our team will review it and provide feedback within a few days.

What We’re Looking For

  • Tutorials — step-by-step guides on .NET, Azure, AI, Blazor, Aspire, and more
  • Deep dives — in-depth explorations of a technology, pattern, or architecture
  • Community stories — your experience building with .NET in production
  • Event recaps — summaries of conferences, meetups, or webinars

Guidelines

  • Content should be technical and relevant to the .NET ecosystem
  • Code examples must be accurate and tested against a real project
  • Include a meaningful description and at least one relevant tag
  • Posts are automatically translated into all supported languages

Get in Touch

Open an issue on GitHub or reach out on X / Twitter. We’d love to have you as part of the community!