# PagoPA DevEx Documentation

> Complete reference documentation for My Project

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [Manage API Access and Policies](https://dx.pagopa.it/azure/apim/api-access-policies.md): This documentation outlines a few best practices for software engineers using
- [Test APIs in Production](https://dx.pagopa.it/azure/apim/debugging.md): APIM provides built-in capabilities for testing in production, offering a
- [Leveraging API Management](https://dx.pagopa.it/azure/apim/index.md): Azure API Management (APIM) is a cloud-based service that enables organizations
- [Defining Secrets, Application Settings and Feature Flags](https://dx.pagopa.it/azure/app-configuration/appsettings-definition.md): Secrets, application settings and feature flags can be defined in a JSON file,
- [Deploying secrets and application settings using GitHub Actions](https://dx.pagopa.it/azure/app-configuration/appsettings-deploy.md): Deploying application settings and secrets to Azure App Configuration can be
- [Setting up Azure App Configuration and KeyVault](https://dx.pagopa.it/azure/app-configuration/azure-app-configuration.md): Azure App Configuration is a managed service that helps developers centralize
- [Managing AppSettings and Secrets With Azure](https://dx.pagopa.it/azure/app-configuration/index.md): This documentation provides guidance on managing application settings and
- [Using Secrets in AppService Environment Variables](https://dx.pagopa.it/azure/application-deployment/appservice-hidden-appsettings.md): Using secret values in AppService (or FunctionApp) is a common challenge for
- [Deploying Applications to Azure](https://dx.pagopa.it/azure/application-deployment/index.md): This section provides comprehensive guidance on deploying applications to Azure,
- [Deploy Azure App Service and Function Apps](https://dx.pagopa.it/azure/application-deployment/release-azure-appsvc.md): To deploy your application to Azure App Service or Function Apps, you can use
- [Deploying Apps to Azure Container App](https://dx.pagopa.it/azure/application-deployment/release-container-app.md): This documentation covers the Container App Release reusable workflow defined in
- [Archiving Data for Decommissioned Projects](https://dx.pagopa.it/azure/archive-data.md): When a project is decommissioned, it is important to strike a balance between
- [Following Azure Naming Convention](https://dx.pagopa.it/azure/azure-naming-convention.md): Having a naming convention for your Azure resources is critical for quickly
- [Managing Azure IAM Roles and Permissions](https://dx.pagopa.it/azure/iam/azure-iam.md): Understanding Azure Identity and Access Management (IAM) roles and permissions
- [Configuring Azure Login for GitHub Actions](https://dx.pagopa.it/azure/iam/azure-login.md): There are several ways to log into Azure using a GitHub Action. The DX-preferred
- [Custom Azure Roles](https://dx.pagopa.it/azure/iam/custom-roles.md): The DX team has developed several custom Azure roles to provide granular access
- [Implementing Azure IAM Across Subscriptions using Terraform](https://dx.pagopa.it/azure/iam/iam-cross-subscription.md): Managing Azure Identity and Access Management (IAM) across multiple
- [Configuring Identity and Access Management](https://dx.pagopa.it/azure/iam/index.md): Managing Identity and Access Management (IAM) on Azure is crucial for ensuring
- [Developing on Azure](https://dx.pagopa.it/azure/index.md): This section offers guidance on Azure infrastructure-related topics, common
- [Using EventGrid with Storage Accounts and Azure Functions](https://dx.pagopa.it/azure/integrating-services/eventgrid-storage-functions.md): This is a step-by-step guide to configure Blob Triggers in an Azure Function App
- [Integrating Azure Services](https://dx.pagopa.it/azure/integrating-services/index.md): This section provides guidance on integrating Azure services to build scalable,
- [Managing Azure Service Bus using Terraform](https://dx.pagopa.it/azure/integrating-services/using-service-bus.md): Azure Service Bus is an enterprise service broker with message queues and
- [Integrating Tracing in Azure NodeJS Applications](https://dx.pagopa.it/azure/monitoring/azure-tracing.md): This guide covers the integration of Azure services with OpenTelemetry (OT) for
- [Monitoring Azure Applications](https://dx.pagopa.it/azure/monitoring/index.md): This section provides comprehensive guidance on monitoring and observability for
- [Adding a TLS certificate to Azure Application Gateway](https://dx.pagopa.it/azure/networking/app-gateway-tls-cert.md): When you expose a new hostname through Azure Application Gateway (App Gateway),
- [Verifying Online Service Reachability from an App Service Plan](https://dx.pagopa.it/azure/networking/appservice-plan-dns-resolution.md): When updating connection configurations for an App Service or Function App in
- [Creating a new TLS certificate](https://dx.pagopa.it/azure/networking/creating-tls-cert.md): Creating and managing a TLS certificate can be a demanding and challenging task
- [Connecting Azure Resources Securely](https://dx.pagopa.it/azure/networking/index.md): This section provides comprehensive guides for configuring and managing network
- [Connecting resources across Azure Subscriptions via Private Endpoints](https://dx.pagopa.it/azure/networking/peps-cross-subscription.md): This guide explains how to enable network connectivity between two Azure
- [Creating and Managing Azure Policies](https://dx.pagopa.it/azure/policies/index.md): Azure Policies are governance tools provided by Microsoft Azure to create,
- [DX Policy Rules Catalog](https://dx.pagopa.it/azure/policies/policy-catalog/index.md): The DX team provides a set of predefined **Azure Policy Rules** to ensure
- [Specific TAGs](https://dx.pagopa.it/azure/policies/policy-catalog/specific-tags.md): This policy rule ensures that all Azure resources comply with a predefined set
- [Deploying a Static Site to Azure](https://dx.pagopa.it/azure/static-websites/build-deploy-static-assets.md): The
- [Deploying an Azure Static Web App](https://dx.pagopa.it/azure/static-websites/build-deploy-static-web-app.md): This guide provides a complete walkthrough for setting up and deploying a static
- [Hosting Static Websites on Azure](https://dx.pagopa.it/azure/static-websites/index.md): This documentation provides a comprehensive guide on hosting static websites
- [Deploying Static Assets](https://dx.pagopa.it/azure/static-websites/static-assets-deploy.md): The
- [Using DX Azure Terraform Provider](https://dx.pagopa.it/azure/using-azure-registry-provider.md): The DX Azure Terraform provider simplifies the creation and management of Azure
- [DX MCP Server](https://dx.pagopa.it/coding-with-ai/dx-mcp-server.md): The **DX MCP Server** is a Model Context Protocol (MCP) server that empowers AI
- [Coding with AI](https://dx.pagopa.it/coding-with-ai/index.md): AI is transforming the way we develop software, enabling new levels of
- [Prompts Catalog](https://dx.pagopa.it/coding-with-ai/prompts-catalog.md): Browse all available MCP prompts for the PagoPA DX ecosystem. Each prompt is a
- [Building Docker Images](https://dx.pagopa.it/containers/docker-image-build.md): The
- [Working with Containers](https://dx.pagopa.it/containers/index.md): Containers provides consistent, portable, and scalable environments. Our DX
- [Contributing to the DX Azure Provider](https://dx.pagopa.it/contributing/contributing-to-dx-provider.md): We appreciate your interest in contributing to the DX Azure provider! This
- [Contributing to DX Terraform Modules](https://dx.pagopa.it/contributing/contributing-to-dx-terraform-modules.md): This guide walks through the process of creating, developing, and publishing
- [Documenting DX Terraform Modules](https://dx.pagopa.it/contributing/documenting-dx-terraform-modules.md): This guide outlines the standards and best practices for writing documentation
- [Contributing to DX](https://dx.pagopa.it/contributing/index.md): This section provides guidelines for contributing to the DX project, including
- [Setting Up Dev Containers](https://dx.pagopa.it/dev-containers/index.md): > A development container (or dev container for short) allows you to use a
- [GitHub Personal Access Token Setup](https://dx.pagopa.it/dx-cli/github-pat.md): How to generate and configure a GitHub Personal Access Token for DX CLI operations.
- [Using the DX CLI](https://dx.pagopa.it/dx-cli/index.md): Documentation for @pagopa/dx-cli commands and usage.
- [Branch Naming Conventions](https://dx.pagopa.it/github/git/branch-name.md): To maintain consistency and clarity in your team's Git workflow, you may want to
- [Commit Message Guidelines](https://dx.pagopa.it/github/git/commit-message.md): Writing clear and well-structured commit messages improves collaboration, makes
- [Git Configuration](https://dx.pagopa.it/github/git/git-config.md): Setting up your Git profile with the correct `user.name` and `user.email` is
- [Git](https://dx.pagopa.it/github/git/index.md): - [Branch Naming Conventions](branch-name.md): guidelines for naming branches to
- [Collaborating on GitHub](https://dx.pagopa.it/github/index.md): This section contains documentation of approaches and convention carried out to
- [Contribution Acceptance Criteria](https://dx.pagopa.it/github/pull-requests/acceptance-criteria.md): To increase the likelihood of PR approval, consider meeting the following
- [Auto Merge](https://dx.pagopa.it/github/pull-requests/auto-merge.md): [Auto-merge is a powerful feature in GitHub](https://github.blog/changelog/2021-02-04-pull-request-auto-merge-is-now-generally-available/)
- [Changeset](https://dx.pagopa.it/github/pull-requests/changeset.md): This document provides guidelines on how to create and manage changesets, which
- [Conventional Comments](https://dx.pagopa.it/github/pull-requests/code-review/conventional-comments.md): Conventional comments provide a standardized way to write comments that are easy
- [Code Reviews](https://dx.pagopa.it/github/pull-requests/code-review/index.md): The author of a Pull Request (PR) is responsible for finding the optimal
- [Format for Pull Requests](https://dx.pagopa.it/github/pull-requests/format.md): This document outlines the required format for pull requests to ensure clarity
- [Pull Requests](https://dx.pagopa.it/github/pull-requests/index.md): Pull requests (PRs) are a critical part of the development workflow, enabling
- [Getting Started with PagoPA DX](https://dx.pagopa.it/index.md): Accelerate your development with proven tools, patterns, and best practices for building scalable applications.
- [Deprecated Legacy Tools](https://dx.pagopa.it/legacy/index.md): This section provides information about legacy workflows that are no longer
- [Using the Code Review Workflow (deprecated)](https://dx.pagopa.it/legacy/legacy-code-review.md): The
- [Deploying a legacy Node.js Application to Azure (deprecated)](https://dx.pagopa.it/legacy/legacy-deploy-pipelines-azure.md): The
- [Publishing an SDK to npm (deprecated)](https://dx.pagopa.it/legacy/legacy-publish-sdk.md): The
- [Creating a DX-Ready Monorepo on GitHub](https://dx.pagopa.it/monorepository-setup.md): This guide provides step-by-step instructions for creating and setting up a new
- [Connecting Multiple Cloud Providers](https://dx.pagopa.it/multi-csp/index.md): Break down cloud silos and unlock the power of multi-cloud architecture. Our
- [Managing DX Pipelines](https://dx.pagopa.it/pipelines/index.md): This section contains documentation on GitHub Actions workflows that automate
- [Keeping Scheduled GitHub Actions Alive](https://dx.pagopa.it/pipelines/keep-alive.md): The
- [Setting Up Pipeline Triggers](https://dx.pagopa.it/pipelines/triggers.md): Triggers in a CI/CD pipeline are more than just automated switches; they embody
- [Getting Support](https://dx.pagopa.it/support.md): The [DX team](https://github.com/orgs/pagopa/teams/engineering-team-devex) is
- [Detecting Drift in Infrastructure as Code](https://dx.pagopa.it/terraform/drift-detection.md): The
- [Working with Terraform](https://dx.pagopa.it/terraform/index.md): This section offers comprehensive guidance on infrastructure-related topics,
- [Deploying Infrastructure Changes](https://dx.pagopa.it/terraform/infra-apply.md): This document describes the GitHub workflow that automates Terraform apply
- [Infrastructure Folder Structure](https://dx.pagopa.it/terraform/infra-folder-structure.md): Each GitHub repository should follow the same folder structure to hold
- [Reviewing Infrastructure Changes](https://dx.pagopa.it/terraform/infra-plan.md): This page describes the GitHub workflow that automates Terraform plan
- [Configuring pre-commit hooks for Terraform to ensure smooth module upgrades](https://dx.pagopa.it/terraform/pre-commit-terraform.md): This guide explains how to configure pre-commit hooks for Terraform projects,
- [Validating Terraform HCL Code](https://dx.pagopa.it/terraform/static-analysis.md): The
- [Using DX Terraform Modules](https://dx.pagopa.it/terraform/using-terraform-registry-modules.md): The Terraform Registry serves as a central repository for discovering, sharing,
- [Reviewing TypeScript Code](https://dx.pagopa.it/typescript/code-review.md): The
- [Configuring ESLint](https://dx.pagopa.it/typescript/eslint-config.md): The `@pagopa/eslint-config` package provides a shared ESLint configuration for
- [Building with TypeScript](https://dx.pagopa.it/typescript/index.md): [TypeScript](https://pagopa.github.io/technology-radar/languages-and-frameworks/typescript.html)
- [Naming Convention for npm Scripts](https://dx.pagopa.it/typescript/npm-scripts.md): Node.js compatible package managers, such as npm, Yarn and pnpm, support the
- [DevEx Initiative: Transforming the Development Experience at PagoPA](https://dx.pagopa.it/blog/001-devex-initiative.md): Transforming the Development Experience at PagoPA
- [Benchmark for Typescript Code Generators from OpenAPI](https://dx.pagopa.it/blog/002-benchmark-openapi-gen.md): Generating TypeScript Code from OpenAPI Specification
- [Introducing the 'Azure GitHub Environment Bootstrap' Terraform Module to Enhance New Project Startup](https://dx.pagopa.it/blog/003-azure-github-environment-bootstrap.md): Boosting Brand New Repository Setup
- [Publishing Terraform Modules and Provider from Our Monorepo: Lessons Learned](https://dx.pagopa.it/blog/004-terraform-registry-journey.md): How we managed to publish and maintain Terraform modules and provider from our monorepo
- [Introducing the 'Azure Service Bus Namespace' Terraform Module and Usage Patterns to Facilitate Service Bus Setup](https://dx.pagopa.it/blog/005-azure-servicebus-namespace.md): Boosting Service Bus setup
- [Introducing the Azure Service Bus Alerts Terraform Module](https://dx.pagopa.it/blog/006-azure-servicebus-alerts.md): Boosting Service Bus setup
- [Migrating to PNPM: What's Next for the PagoPA DX Toolchain](https://dx.pagopa.it/blog/007-migrating-to-pnpm.md): import Tabs from "@theme/Tabs";
- [Introducing SaveMoney: Smart FinOps for Azure Resources](https://dx.pagopa.it/blog/008-savemoney-finops.md): A data-driven approach to identifying unused and cost-inefficient cloud resources with the DX CLI