Commit 60a5c64c authored by Gokhan Boranalp's avatar Gokhan Boranalp

ulakbus.org added, gitter chat room added

ulakbus.org added, gitter chat room added
parent 73e2766b
#Ulakbus User Interface
#Ulakbüs - Bütünleşik Üniversite Sistemi
##Get Ready For Development
1. Get Repo `git clone git@github.com:zetaops/ulakbus-ui.git`
Belgeler ve projemiz hakkında detaylı bilgi için Ulakbüs resmi sitesini ziyaret ediniz. http://www.ulakbus.org
*if you are not familiar with git follow these guides:*
- https://git-scm.com/doc
- https://try.github.io/levels/1/challenges/1
[![Sohbet odamız açıldı. https://gitter.im/kunthar/ulakbus](https://badges.gitter.im/ulakbus/gitter.svg)](https://gitter.im/kunthar/ulakbus)
2. Download and Install nodejs:
- https://nodejs.org/download/
3. Install Bower `npm install bower`
4. run `bower install` to install packages listed in bower.json
5. run `npm install` to install packages listed in package.json
6. After getting all packages and installing all dependencies run this command to start http server:
```
npm start
```
*you can use any other http server to serve app*
##Development Cycle
Now that you have the repo, npm and bower installed, you may now start to develop.
Using extreme programming techniques, we demand you to follow this cycle of development showing on the first page of xp website: http://www.extremeprogramming.org/introduction.html
![extreme programming cycle]
(https://upload.wikimedia.org/wikipedia/commons/thumb/8/84/Extreme_Programming.svg/640px-Extreme_Programming.svg.png?1433328761062)
Undermost, there is coding step, name is CODE. Follow these steps when you code:
- before you code anything create a branch with name related to the given task (e.g: search_func)
- `git checkout <branch>`
- `git pull --rebase`
- after you create the branch for given task and rebase master, now you can write down your code
- write tests for your code
- run your tests
- before you push to your branch rebase master again `git pull --rebase`
- now that you can push to your branch `git push origin <branch>`
##Testing
*_test.js files are unit test files coded in Jasmine. to run tests run this command:
npm test
this command will recognize test cases and printout the test result.
To run e2e tests, which is located under e2e-tests folder, we use protractor. Run this command to run e2e tests:
protractor e2e-tests/protractor.conf.js
##Principles
###Git:
- Always work with branches
- **NEVER MESS WITH MASTER BRANCH!!**
- Commit by little changes
###Code:
- DRY - don't repeat yourself (no idea? read this: https://en.wikipedia.org/wiki/Don%27t_repeat_yourself)
- Use comments to explain what your code does
- Code clean and neat
- Name variables, objects with expository words
###Test:
- Follow this guide to write effective test cases: http://www.softwaretestinghelp.com/how-to-write-effective-test-cases-test-cases-procedures-and-definitions/
- Tests must be cover as much as possible of your code.
##Must Reads:
- https://google-styleguide.googlecode.com/svn/trunk/angularjs-google-style.html
- https://github.com/angular/angular.js/wiki/Best-Practices
- https://angular.github.io/protractor/#/tutorial
- https://docs.angularjs.org/guide
- http://en.wikipedia.org/wiki/Iterative_and_incremental_development
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment