2015-07-03 07:24:54 -05:00
|
|
|
# SQL style guide
|
|
|
|
|
2015-07-13 06:54:36 -05:00
|
|
|
**[Read the guide](http://www.sqlstyle.guide)**
|
|
|
|
|
2015-07-03 07:24:54 -05:00
|
|
|
---
|
2015-07-03 10:27:31 -05:00
|
|
|
|
2015-07-13 06:54:36 -05:00
|
|
|
## General
|
|
|
|
|
|
|
|
The guide is written in [Markdown][md-lang] and uses [Jekyll][jekyll] via
|
|
|
|
[GitHub's Pages][gh-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][md]
|
|
|
|
|
2015-07-03 10:27:31 -05:00
|
|
|
## Installing for local development
|
|
|
|
|
2015-07-13 06:54:36 -05:00
|
|
|
There is a Gemfile supplied so you just need to follow the
|
|
|
|
[GitHub Pages documentation][gh-pages-help] to install the dependencies.
|
2015-07-03 10:27:31 -05:00
|
|
|
|
|
|
|
To then run it locally `bundle exec jekyll serve`
|
2015-07-13 06:54:36 -05:00
|
|
|
|
2016-08-31 18:10:29 -05:00
|
|
|
## Projects known to be implementing the guide
|
2015-07-13 06:54:36 -05:00
|
|
|
|
2016-08-31 18:10:29 -05:00
|
|
|
If your project uses this styleguide and you'd like to be mentioned in this readme then
|
2016-08-31 22:23:36 -05:00
|
|
|
please open a pull request adding it below in alphabetical order with a URL and short
|
|
|
|
description.
|
2016-08-31 18:10:29 -05:00
|
|
|
|
|
|
|
* [Stock Talk](https://github.com/nigelgilbert/stock-talk) - a realtime dashboard that displays the stock data of the most Tweeted Nasdaq companies.
|
2015-07-13 06:54:36 -05:00
|
|
|
|
2016-08-31 22:23:36 -05:00
|
|
|
## 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](https://github.com/lumoslabs/sqlstyle.guide) - removed the river, Redshift, etc. [www](http://engineering.lumosity.com/sqlstyle.guide)
|
|
|
|
|
|
|
|
|
2015-07-13 06:54:36 -05:00
|
|
|
[md-lang]: http://daringfireball.net/projects/markdown/
|
|
|
|
[jekyll]: http://jekyllrb.com/
|
|
|
|
[gh-pages]: https://pages.github.com/
|
|
|
|
[md]: https://github.com/treffynnon/sqlstyle.guide/blob/gh-pages/_includes/sqlstyle.guide.md
|
|
|
|
[gh-pages-help]: https://help.github.com/articles/using-jekyll-with-pages/#installing-jekyll
|
|
|
|
|