Skip to content

Conversation

@akuzminsky
Copy link
Collaborator

Add detailed standards for Python, Terraform, and Makefile conventions:

Python Standards:

  • Code formatting (Black), linting (pylint), type hints (required)
  • Testing philosophy (meaningful tests, no coverage requirements)
  • Error handling (never use bare except Exception)
  • Logging (setup_logging from infrahouse_core)
  • InfraHouse packages architecture (infrahouse-core vs infrahouse-toolkit)

Terraform Standards:

  • Naming conventions (snake_case, boolean prefixes, resource patterns)
  • Complete variable guidelines (types, defaults, validation, sensitive)
  • Output standards, documentation requirements
  • Resource organization (count vs for_each, locals, file structure)
  • Comprehensive security (secrets, encryption, logging, ISO/SOC compliance)
  • Expanded validation examples (including nullable ternary operator pattern)
  • IAM policy patterns, tagging conventions, testing workflow

Makefile Standards:

  • Required targets (help, bootstrap, install-hooks, test, clean, format, lint, release-*)
  • Target naming conventions and PHONY declarations
  • Examples for common patterns

Add detailed standards for Python, Terraform, and Makefile conventions:

Python Standards:
- Code formatting (Black), linting (pylint), type hints (required)
- Testing philosophy (meaningful tests, no coverage requirements)
- Error handling (never use bare except Exception)
- Logging (setup_logging from infrahouse_core)
- InfraHouse packages architecture (infrahouse-core vs infrahouse-toolkit)

Terraform Standards:
- Naming conventions (snake_case, boolean prefixes, resource patterns)
- Complete variable guidelines (types, defaults, validation, sensitive)
- Output standards, documentation requirements
- Resource organization (count vs for_each, locals, file structure)
- Comprehensive security (secrets, encryption, logging, ISO/SOC compliance)
- Expanded validation examples (including nullable ternary operator pattern)
- IAM policy patterns, tagging conventions, testing workflow

Makefile Standards:
- Required targets (help, bootstrap, install-hooks, test, clean, format, lint, release-*)
- Target naming conventions and PHONY declarations
- Examples for common patterns
@github-actions
Copy link

github-actions bot commented Jan 7, 2026

Comment was too big. Check the CI workflow output.

@akuzminsky akuzminsky merged commit 2560ca1 into main Jan 7, 2026
1 check passed
@akuzminsky akuzminsky deleted the enhance-coding-standards branch January 7, 2026 17:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants