Difference between revisions of "Make software accessible"
(→Training Materials) |
(→What To Do) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
== What This Task Involves == | == What This Task Involves == | ||
| − | 1. Understand how to use GitHub to make software accessible | + | 1. Understand how to use GitHub to make software accessible<br/> |
== Training Materials == | == Training Materials == | ||
| Line 52: | Line 52: | ||
== What To Do == | == What To Do == | ||
| − | + | Create a GitHub account and contribute your project to GitHub | |
Latest revision as of 19:41, 8 May 2015
What This Task Involves
1. Understand how to use GitHub to make software accessible
Training Materials
This training session was held on March 6, 2015:
- Presentation -- to be posted
- Step-by-step guide on setting up GitHub
1. Pre-Requisites
1.1 Download and install hub.github.com. You will need to install 'brew', and 'go' after.
1.2 Install brew Untar anywhere and then symlink the brew command elsewhere.
$ mkdir /usr/local/homebrew && curl -L https://github.com/Homebrew/homebrew/tarball/master | tar xz --strip 1 -C homebrew $ cd /usr/local/bin $ sudo ln -s /usr/local/homebrew/bin/brew brew
2. Brew Dependencies
2.1 Install go $ brew install go add path to .cshrc and/or .bashrc:
setenv GOPATH /usr/local/homebrew/Cellar/go/1.4.2/bin (csh) export GOPATH=/usr/local/homebrew/Cellar/go/1.4.2/bin (bash)
2.2 Install hub
$ cd $HOME/src && git clone https://github.com/github/hub.git $ cd hub $ script/build $ mv ./hub ~/bin # (make sure your PATH includes $HOME/bin)
3.Git SSH Keys
3.1 follow this guide to make sure that you have Git SSH keys: https://help.github.com/articles/generating-ssh-keys/ TL;DR version:
a. ssh-keygen -t rsa -C "your_email@example.com”
b. don’t use a passphrase (will be annoying if you later)
c. grab the value out of $HOME/.ssh/id_rsa.pub and then go over to your Github account > Settings > SSH keys and paste the value of the id_rsa.pub file into the key setting.
4. Create your project locally and then check in to Git
4.1 $mkdir -p $HOME/src/<your project name> (Create your local project)
4.2 $cd $HOME/src/<your project name> (Change the current working directory to your local project)
4.3 Edit and add a README.md file.
4.4 Edit and add a LICENSE.txt file (suggestion: Apache License, version 2)
4.5 Add your pom.xml file and/or setup.py file and/or .PM file.
4.6 Add your dependencies.
4.7 $git init (to initialize your working repo in this dir)
4.8 $git add * (to add all the uncommitted files)
4.9 $git commit -m 'Initial commit'
4.10 $git create
4.11 $git push origin master
4.12 Visit https://github.com/<your username>/<your project>.git and there is your project!
Suggested Readings
- TBD
What To Do
Create a GitHub account and contribute your project to GitHub
