53 results for "all documents"
core/principles/dry_kiss_yagni.md
Sandi Metz's 'wrong abstraction' pattern, Kent C. Dodds's AHA alternative to DRY/WET, and the correctly-attributed Rule of Three, with the concrete failure signatures that tell you which side of the DRY tension you're ac...
languages/python/frameworks/fastapi/best_practices.md
Version-specific FastAPI/Pydantic v2 gotchas: verified current releases, yield-dependency cleanup timing, BackgroundTasks/middleware footguns, threadpool starvation, and Pydantic v2 union-resolution traps - with sources.
databases/sql/general_sql_patterns.md
Cross-engine SQL guidance beyond textbook fundamentals: the GitLab 2017 backup-failure postmortem, why REPEATABLE READ silently permits write skew, sourced connection-pool sizing formulas, and SQL:2023's JSON type and pr...
tools/git/best_practices.md
Conventional commit standards, a comparison of trunk-based development, GitFlow, and GitHub Flow branching models, rebase versus merge trade-offs, commit signing, and monorepo versus polyrepo workflow guidance.
tools/gitea/gitea_actions.md
Complete reference for configuring and using Gitea Actions as a built-in CI/CD solution. Covers .gitea directory structure, workflow YAML syntax, runner setup, GITEA_TOKEN permissions, secrets, variables, scoped workflow...
languages/go/best_practices.md
Current idiomatic-vs-outdated verdicts for Go error handling (errors.AsType, errors.Join), concurrency (WaitGroup.Go, testing/synctest, errgroup), and context.Context - backed by named production goroutine-leak research ...
languages/go/README.md
Verified current Go release state (1.26.x, 1.27 pending Aug 2026), the semantic changes since 1.21 that actually alter idiomatic code (loop-var scoping, range-over-func, generic type aliases, tool directive, errors.AsTyp...
core/architecture/hexagonal.md
Concrete thresholds for adopting Ports & Adapters, named criticism of boilerplate-heavy misapplication, and how the pattern's testing payoff should be measured rather than assumed.
core/testing/integration_testing.md
How to test across real system boundaries - databases, HTTP APIs, and message queues - using ephemeral test infrastructure (Testcontainers) and consumer-driven contract testing (Pact-style), with an honest accounting of ...
languages/javascript/code_style_guide.md
Agent-facing linter/formatter decision guidance for 2026: Biome 2.x's type-aware linting (no TS compiler needed), current ESLint/typescript-eslint/eslint-plugin-react-hooks versions, and when ESLint's plugin ecosystem st...