# treffynnon/sqlstyle.guide

A consistent code style guide for SQL to ensure legible and maintainable projects

Repository: https://github.com/treffynnon/sqlstyle.guide
Canonical: https://ross.abutalabs.com/products/sqlstyleguide
Homepage: https://www.sqlstyle.guide
Language: HTML
License: NOASSERTION
License Family: other
Topics: sql, styleguide
Last push: 2026-03-17T00:44:06+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 72, release rhythm 35, longevity 100
- inputs: {"age_days": 4069, "days_push": 170, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1519, forks 1525 (observed 2026-08-28T04:04:57.530124+00:00)

## What it is
A community SQL code style guide published as a static website (sqlstyle.guide), written in Markdown and rendered with Jekyll on GitHub Pages. It defines conventions for naming, formatting, and structuring SQL for legible, maintainable projects and is available in many translations.

## Use cases
- standardize SQL formatting across a team
- decide how to name tables and columns in a database schema
- set up a SQL style convention for a new project
- reference a consistent SQL style in code review
- find a translated SQL style guide for non-English teams

## When to choose
- you want an established, widely referenced SQL style convention
- you need a Markdown style guide you can vendor into your repo
- your team wants a Celko-compatible but more succinct SQL style

## When to avoid
- you need an automated SQL formatter or linter rather than a written guide
- you require vendor-specific SQL conventions for a single database engine
- you want executable tooling instead of documentation

## Facets
- artifact type: learning-resource
- maturity: stable
- function: documentation, markdown
- domain: databases, documentation, developer-tools
- platform: cli
- tags: sql, style-guide, code-style, jekyll, static-site, web-server

## Member repositories
- treffynnon/sqlstyle.guide (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:57.530124+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:58.733269+00:00, confidence not recorded.
  - readme: https://github.com/treffynnon/sqlstyle.guide (fetched 2026-08-28T04:04:57.530124+00:00, sha 2ae83901ae30)
  - homepage: https://www.sqlstyle.guide (fetched 2026-08-29T11:35:10.299694+00:00, sha 569d585652a3)
- Data as of 2026-08-30T08:39:29.467469+00:00.