Merge pull request #3124 from dosire/comprehensive-readme
Cleaned up and enhanced readme.
This commit is contained in:
commit
bd3848c05b
1 changed files with 63 additions and 31 deletions
94
README.md
94
README.md
|
@ -1,52 +1,84 @@
|
||||||
## GitLab is a self hosted Git management software.
|
## GitLab: self hosted Git management software
|
||||||
|
|
||||||
Check out [gitlab.org](http://gitlab.org)
|
|
||||||
|
|
||||||
![logo](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png)
|
![logo](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png)
|
||||||
|
|
||||||
With GitLab you can:
|
### GitLab allows you to
|
||||||
* create projects and repositories
|
* keep your code secure on your own server
|
||||||
* manage repositories access
|
* manage repositories, users and access permissions
|
||||||
* do code review
|
* communicate though issues, line-comments and wiki's
|
||||||
|
* perform code reviews with merge requests
|
||||||
|
|
||||||
- - -
|
### GitLab is
|
||||||
|
|
||||||
### Code status:
|
|
||||||
|
|
||||||
* master: travis-ci.org
|
|
||||||
[![build status](https://secure.travis-ci.org/gitlabhq/gitlabhq.png)](https://travis-ci.org/gitlabhq/gitlabhq)
|
|
||||||
|
|
||||||
* master: ci.gitlab.org
|
|
||||||
[![CI](http://ci.gitlab.org/projects/1/status?ref=master)](http://ci.gitlab.org/projects/1?ref=master)
|
|
||||||
|
|
||||||
* [![Code Climate](https://codeclimate.com/github/gitlabhq/gitlabhq.png)](https://codeclimate.com/github/gitlabhq/gitlabhq)
|
|
||||||
* [![Dependency Status](https://gemnasium.com/gitlabhq/gitlabhq.png)](https://gemnasium.com/gitlabhq/gitlabhq)
|
|
||||||
|
|
||||||
### Application details
|
|
||||||
|
|
||||||
* powered by Ruby on Rails
|
* powered by Ruby on Rails
|
||||||
* its completely free and open source
|
* completely free and open source (MIT license)
|
||||||
* distributed under the MIT License
|
* used by 10.000 organization to keep their code secure
|
||||||
|
|
||||||
|
### Code status
|
||||||
|
|
||||||
|
* [![build status](http://ci.gitlab.org/projects/1/status?ref=master)](http://ci.gitlab.org/projects/1?ref=master) ci.gitlab.org (master branch)
|
||||||
|
|
||||||
|
* [![build status](https://secure.travis-ci.org/gitlabhq/gitlabhq.png)](https://travis-ci.org/gitlabhq/gitlabhq) travis-ci.org (master branch)
|
||||||
|
|
||||||
|
* [![Code Climate](https://codeclimate.com/github/gitlabhq/gitlabhq.png)](https://codeclimate.com/github/gitlabhq/gitlabhq)
|
||||||
|
|
||||||
|
* [![Dependency Status](https://gemnasium.com/gitlabhq/gitlabhq.png)](https://gemnasium.com/gitlabhq/gitlabhq)
|
||||||
|
|
||||||
|
### Resources
|
||||||
|
|
||||||
|
* GitLab.org community site: [Homepage](http://gitlab.org) [Screenshots](http://gitlab.org/screenshots/) [Blog](http://blog.gitlab.org/) [Demo](http://demo.gitlabhq.com/users/sign_in)
|
||||||
|
|
||||||
|
* GitLab.com: [Homepage](http://blog.gitlab.com/) [Hosted pricing](http://blog.gitlab.com/pricing/) [Services](http://blog.gitlab.com/services/) [Blog](http://blog.gitlab.com/blog/)
|
||||||
|
|
||||||
|
* GitLab CI: [Readme](https://github.com/gitlabhq/gitlab-ci/blob/master/README.md) of the GitLab open-source continuous integration server
|
||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
* Ubuntu/Debian
|
* Ubuntu/Debian*
|
||||||
* ruby 1.9.3+
|
* ruby 1.9.3+
|
||||||
* MySQL
|
* MySQL
|
||||||
* git
|
* git
|
||||||
* gitlab-shell
|
* gitlab-shell
|
||||||
* redis
|
* redis
|
||||||
|
|
||||||
More details are in the [requirements doc](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/requirements.md)
|
* More details are in the [requirements doc](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/requirements.md)
|
||||||
|
|
||||||
### Install
|
### Getting started
|
||||||
|
|
||||||
Checkout [wiki](https://github.com/gitlabhq/gitlabhq/wiki) pages for installation information, migration, etc.
|
* [Installation guide for latest stable release](https://github.com/gitlabhq/gitlabhq/blob/4-2-stable/doc/install/installation.md)
|
||||||
|
|
||||||
### [Community](http://gitlab.org/community/)
|
* [Installation guide for the current master branch](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md)
|
||||||
|
|
||||||
### [Contact](http://gitlab.org/contact/)
|
* [Vagrant virtual machine](https://github.com/gitlabhq/gitlab-vagrant-vm)
|
||||||
|
|
||||||
### [Contributing Guide](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md)
|
* [Developer guide](https://github.com/gitlabhq/gitlabhq/wiki/Developer-Guide)
|
||||||
|
|
||||||
### [Developer Guide](https://github.com/gitlabhq/gitlabhq/wiki/Developer-Guide)
|
* [Upgrade guides](https://github.com/gitlabhq/gitlabhq/wiki)
|
||||||
|
|
||||||
|
* [Roadmap](https://github.com/gitlabhq/gitlabhq/blob/master/ROADMAP.md)
|
||||||
|
|
||||||
|
* [GitLab API](https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/README.md)
|
||||||
|
|
||||||
|
### Getting help
|
||||||
|
|
||||||
|
* [Troubleshooting guide](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide)
|
||||||
|
|
||||||
|
* [Support forum](https://groups.google.com/forum/#!forum/gitlabhq)
|
||||||
|
|
||||||
|
* [Feedback and suggestions forum](http://gitlab.uservoice.com/forums/176466-general)
|
||||||
|
|
||||||
|
* [Paid support](http://blog.gitlab.com/support/)
|
||||||
|
|
||||||
|
* [Paid services](http://blog.gitlab.com/services/)
|
||||||
|
|
||||||
|
### Getting in touch
|
||||||
|
|
||||||
|
* [Contributing guide](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md)
|
||||||
|
|
||||||
|
* [Core team](https://github.com/gitlabhq?tab=members)
|
||||||
|
|
||||||
|
* [Contributors](https://github.com/gitlabhq/gitlabhq/graphs/contributors)
|
||||||
|
|
||||||
|
* [Leader](https://github.com/randx)
|
||||||
|
|
||||||
|
* [Contact page](http://gitlab.org/contact/)
|
||||||
|
|
Loading…
Add table
Reference in a new issue