CodeandCoffeeLB website!Welcome to the official repo for the
Last Update: February 8th, 2016
Clone this repo!
First things first. Make a local clone of this repo so you can work on it from your own computer.
Install, and Serve!
This website was built using Jekyll. So if you are familiar with this and already have Jekyll installed, you can scroll past the instructions we have below.
Setting up your development environment
To do this, you are going to need a computer capable of running Ruby - while Mac OSX or Linux tends to be easiest, plenty of people do Ruby development on Windows as well. If you're not on Mac OSX, you will likely need to install Ruby yourself.
Install Gems and Serving the Website
gem install jekyll gem install bundle
This will install Bundler and Jekyll. If you have any errors, check to be sure you have installed Ruby correctly.
Next, install the projects dependencies and serve:
bundle install bundle exec jekyll serve
This should start serving the website on http://0.0.0.0:4000/ - simply make changes to the source code and can see your changes live at that URL!
However, we do have some rules and general guidelines we would like you to follow:
Everything must start with an issue...
- Issues should have useful, concise titles and enough of a description to understand the scope of the issue.
Branches should link to individual issues, and be named using consistent syntax consisting of "issue type", "issue number", and an descriptive title (using hyphens for spaces, and all lower case). Examples:
A branch should represent an atomic change
- Merging the branch should not break anything. A branch should be fully testable and functional once finished - I should be able to deploy any given branch and have a functional site.
All pull requests should merge to development. Only an admin should merge to master.
Pull requests may not be merged by the requester. Ever.
Once a pull request is merged, the branch should be removed.
Pull Requests should use Github keywords so they automatically link to/close related issues.
Always follow good Github etiquette. Several helpful reads on the topic: