From 70c2f6bac5d95716a7a4e9e537c83070ead77f0a Mon Sep 17 00:00:00 2001 From: Lee Reilly Date: Mon, 27 May 2013 16:05:26 -0700 Subject: [PATCH] Add CONTRIBUTING file --- CONTRIBUTING.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..29023c89b7 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,64 @@ +# Contributing to Swot + +#### Data Contributions + +* All of the school data is stored in a simple filesystem data structure under `lib/domains`. +* Every directory name in here is a [TLD](http://en.wikipedia.org/wiki/Top-level_domain) (Top Level Domain) e.g. `edu`. +* Every file in these directories is named after the school's [SLD](http://en.wikipedia.org/wiki/Second-level_domain) (Second Level Domain) e.g `stanford`. +* The contents of that file are simply the school name e.g. `Stanford University`. +* The [working example for Stanford University](https://github.com/leereilly/swot/blob/master/lib/domains/edu/stanford) :eyes: +* Here's what the data structure looks like: + +``` +[-] lib + [-] domains + [-] ac.uk + [+] strath + [-] edu + [+] harvard + [+] stanford + +``` + +##### Adding a School + +Let's say you want to add the [University of Strathclyde](http://www.strath.ac.uk/). We know the TLD is `ac.uk` and the SLD is `strath`. We'd simply create a file at `lib/domains/ac.uk/strath` containing the text `University of Strathcylde`. You can safely ignores subdomain like `www`, `cis`, whatever. You can see the actual file [here](https://github.com/leereilly/swot/blob/master/lib/domains/ac.uk/strath). + +#### Updating a School Name + +Change the file contents of the appropriate file. + +#### Deleting a School Name + +A simple `git rm` on the approriate file will do the trick. + +#### Code Contributions + +This was literally my first Ruby gem, so please keep that in mind when you're looking at the code :trollface: + +* Check out the latest [master](https://github.com/leereilly/swot/tree/master). +* Take a look through the [open pull requests](https://github.com/leereilly/swot/issues) in case someone else has already contributed something similar. +* Fork the project. +* Start a topic branch of your own. +* Commit and push away. Don't forget the tests! +* Submit a pull request. +* :boom: You've contributed to open source! + +``` + ____________________________________________________ + |.==================================================,| + || I WILL MERGE AND REVIEW PULL REQUESTS QUICKLY || + || I WILL MERGE AND REVIEW PULL REQUESTS QUICKLY || + || I WILL MERGE AND REVIEW PULL REQUESTS QUICKLY || + || I .----.ERG, || + || / >< \ / || + || | |/\ || + || \______//\/ || + || _(____)/ / || + ||__/ ,_ _ _/______________________________________|| + '===\___\_) |========================================' + |______| + | || | + |__||__| + (__)(__) +```