Skip to Content
DocumentsStandards & Reference Documents

Documents

Reference documents and standards for platform engineering and DevOps.

Azure Logic App Standards

Azure

Production standards for Azure Logic Apps: hosting model decision tree, Sentinel incident triggers, HTTP and KQL patterns, networking and outbound IPs, retries, error handling, Terraform configuration, dependency chains, and observability.

AzureLogic AppsSentinelTerraform

Azure Naming Convention

Azure

A policy set implementing the recommended Microsoft Azure resource abbreviations, enforcing consistent naming patterns across all Azure resource types.

AzureNamingTerraform

Bash Standards

Bash

Production standards for Bash 4.4+: strict mode and safety, coding style and naming, quoting, functions, error handling and traps, structured logging, observability with otel-cli, Azure Monitor telemetry sync, ShellCheck and bats testing, and CI/CD.

BashShellStandards

CI/CD Standards

CI/CD

Enterprise CI/CD and secure SDLC: pipeline stages, trunk-based branching and PR gates, OIDC identity, secret scanning and git-leak prevention, SAST and dependency scanning, supply-chain hardening, build-once artifacts, and gated multi-environment deployment. Language-agnostic, with GitHub Actions as the worked example.

CI/CDDevSecOpsSDLCGitHub Actions

PowerShell Standards

PowerShell

Production standards for PowerShell 7: coding style and approved verbs, strict mode and structured error handling, native and library-based logging, OpenTelemetry tracing, Azure Monitor telemetry sync, Pester testing, module publishing, and CI/CD.

PowerShellObservabilityStandards

Python Standards

Python

Production standards for Python 3.12+: PEP 8 style and naming, type hints with mypy strict, error handling, structured logging and structlog, OpenTelemetry, Azure Monitor telemetry sync, pytest testing, packaging, and CI/CD.

PythonObservabilityStandards

Terraform Standards

Terraform

Opinionated standards for file structure, provider pinning, variables, locals, outputs, dynamic blocks, check blocks, state management, testing, pipelines, and registry publishing. Grounded in HashiCorp’s official style guide.

TerraformIaCStandards
Last updated on