# Contributing

> 👷 **For Platform Contributors:** This section is for developers contributing to Forge itself.
> If you're building applications with Forge, see [Guides](../../guides/index.md).

This section contains documentation for developers contributing to and maintaining the Forge platform.

---

## 🚀 Getting Started

- [Forge Monorepo](./overview.md) - Overview of the Forge platform architecture and components
- [Design System](./design-system.md) - Visual design tokens, components, and styling guidelines
- [GitHub Copilot Configuration](./copilot-skills.md) - Skills, custom agents, and instructions for platform development assistance

---

## 🔧 Guides

How-to guides for common contributor tasks:

- [Local Testing of Terraform Modules](./terraform-local-testing.md) - Test Terraform modules locally before publishing
- [MSBuild Reference Swap System](./swap-dotnet.md) - Swap between PackageReference and ProjectReference for local development
- [Terraform Module Source Swapper](./swap-terraform-modules.md) - Swap Terraform module sources for local development
- [Project Templates](./project-templates.md) - Creating and modifying dotnet new templates for the platform
- [Update-ForgePackageConfig.ps1](./update-forge-package-config.md) - .NET package-config automation, now part of the azure-devops skill
- [Release Process](./release-process.md) - How to create and publish a new release

---

## 📚 Reference

Technical reference for the platform:

- [Terraform Repositories Inventory](./terraform-repositories-inventory.md) - Complete list of Terraform repositories and modules
