Skip to content

Commit 783c46c

Browse files
committed
Merge pull request #50 from codeandcoffeelb/repoReadme
Updated the Repo Readme
2 parents e849465 + 63ad425 commit 783c46c

File tree

1 file changed

+66
-2
lines changed

1 file changed

+66
-2
lines changed

Diff for: README.md

+66-2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,67 @@
1-
# Welcome to the repo for the codeandcoffeelb website
1+
# Welcome to the official repo for the [CodeandCoffeeLB](http://codeandcoffeelb.github.io/) website!
22

3-
http://codeandcoffeelb.github.io/
3+
Last Update: February 8th, 2016
4+
5+
![alt text](http://i.imgur.com/Mv34V2A.gif "Website Screenshot")
6+
7+
## Clone this repo!
8+
9+
First things first. Make a local clone of this repo so you can work on it from your own computer.
10+
11+
## Install, and Serve!
12+
13+
This website was built using [Jekyll](https://jekyllrb.com/). So if you are familiar with this and already have Jekyll installed, you can scroll past the instructions we have below.
14+
15+
**Setting up your development environment**
16+
17+
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.
18+
19+
**Install Gems and Serving the Website**
20+
21+
The required gems for this project are [Bundler](http://bundler.io/) and [Jekyll](https://jekyllrb.com/). Once you have Ruby installed, open your terminal, `cd` to the local repo directory, and run the following commands:
22+
23+
```
24+
gem install jekyll
25+
gem install bundle
26+
```
27+
28+
This will install Bundler and Jekyll. If you have any errors, check to be sure you have installed Ruby correctly.
29+
30+
Next, install the projects dependencies and serve:
31+
32+
```
33+
bundle install
34+
bundle exec jekyll serve
35+
```
36+
37+
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!
38+
39+
## Contribute!
40+
41+
We are open to all contributions by members of our organization, and we encourage all new members to create their own [Members Page](http://www.codeandcoffeelb.org/members/) using the [instructions provided on our website](http://www.codeandcoffeelb.org/members/#member_howto)
42+
43+
**However, we do have some rules and general guidelines we would like you to follow:**
44+
45+
1. Everything must start with an issue...
46+
* Issues should have useful, concise titles and enough of a description to understand the scope of the issue.
47+
48+
2. 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:
49+
* bug/#123-abbreviated-issue-title
50+
* feature/#123-abbreviated-issue-title
51+
* enhancement/#123-abbreviated-issue-title
52+
53+
3. A branch should represent an atomic change
54+
* 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.
55+
56+
4. All pull requests should merge to development. Only an admin should merge to master.
57+
58+
5. Pull requests may not be merged by the requester. Ever.
59+
60+
6. Once a pull request is merged, the branch should be removed.
61+
62+
7. Pull Requests should use Github keywords so they automatically link to/close related issues.
63+
* For reference: https://help.github.com/articles/closing-issues-via-commit-messages/
64+
65+
8. Always follow good Github etiquette. Several helpful reads on the topic:
66+
* [Git - Contributing to a Project](http://git-scm.com/book/ch5-2.html)
67+
* [Who-T - On Commit Messages](http://who-t.blogspot.com/2009/12/on-commit-messages.html)

0 commit comments

Comments
 (0)