rhanqtl / sqlstyle.guide

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

SQL style guide

☛ Read the guide

---

General

The guide is written in Markdown and uses Jekyll via GitHub's Pages facility to render itself upon pushing to the gh-pages branch.

Sources

The markdown source for the guide can be found in _includes/sqlstyle.guide.md

Installing for local development

There is a Gemfile supplied so you just need to follow the GitHub Pages documentation to install the dependencies.

To then run it locally bundle exec jekyll serve

Translations of the guide

If you would like to translate the guide then please open a pull request or open an issue if you need some help getting it setup.

• German/Deutsch by AStasyK
• Japanese/日本語 by nkurigit
• Portuguese (Brazil)/Português (BR) by pmarcus93
• Russian/Русский by denpatin
• Simplified Chinese/简体中文 by wontoncoder
• Traditional Chinese/正體中文 by Leon0824

Projects known to be implementing the guide

If your project uses this styleguide and you'd like to be mentioned in this readme then please open a pull request adding it below in alphabetical order with a URL and short description.

You can also add a badge () to your projects readme with the following markdown code if you like:

[![sqlstyle.guide](https://img.shields.io/badge/style-sqlstyle.guide-brightgreen.svg)](https://www.sqlstyle.guide/)

• BEdita - a Symfony based PHP CMF
• SQLQuery.jl - A Julia lang package for representing sql queries, and converting them to valid SQL statements
• Stock Talk - a realtime dashboard that displays the stock data of the most Tweeted Nasdaq companies.

Notable forks of the guide

These are based on, but deviate in some way from sqlstyle.guide.

If you have forked this styleguide and you'd like to be mentioned in this readme then please open a pull request adding it below in alphabetical order with a URL and short description of your deviance.

• Lumos Labs - removed the river, Redshift, etc. www
• Mozilla - removed the river, heavily modified www
• Ricardo.ch
• Scout24