From 74029cbbe0d3466167985d90d2ae6aa3ed4dadcd Mon Sep 17 00:00:00 2001 From: James Moger Date: Mon, 16 Jun 2014 10:02:03 -0400 Subject: [PATCH] Documentation --- README.markdown | 38 ++++++++++++++++++++++++++++++++++---- src/site/features.mkd | 21 +++++++++++---------- 2 files changed, 45 insertions(+), 14 deletions(-) diff --git a/README.markdown b/README.markdown index 76c15fce..e720bf5a 100644 --- a/README.markdown +++ b/README.markdown @@ -1,7 +1,8 @@ Gitblit ================= -Gitblit is an open source, pure Java Git solution for managing, viewing, and serving [Git](http://git-scm.com) repositories. +Gitblit is an open source, pure Java Git solution for managing, viewing, and serving [Git](http://git-scm.com) repositories. It can serve repositories over the GIT, HTTP, and SSH transports; it can authenticate against multiple providers; and it allows you to get up-and-running with an attractive, capable Git server in less than 5 minutes. + More information about Gitblit can be found [here](http://gitblit.com). @@ -15,7 +16,27 @@ The text of the license is included in the file LICENSE in the root of the proje Contributing ------------ -GitHub pull requests are preferred. Any contributions must be distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0). +GitHub pull requests or Gitblit Tickets are preferred. Any contributions must be distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0). + +**Workflow** + +Gitblit practices the [git-flow][1] branching model. + +- **master** is the current stable release + fixes accumulated since release. +- **develop** is the integration branch for the next major release. +- **ticket/N** are feature or hotfix branches to be merged to **master** or **develop**, as appropriate. + +**Feature Development** + +Development of new features is mostly done using [Gitblit Tickets][2] hosted at [dev.gitblit.com][3]. This allows continuous dogfooding and improvement of Gitbit's own issue-tracker and pull-request mechanism. + +**Release Planning** + +Release planning is mostly done using Gitblit Milestones and Gitblit Tickets hosted at [dev.gitblit.com][3]. + +**Releasing** + +When Gitblit is preparing for a release, a **release-{milestone}** branch will be created, tested, & fixed until it is ready to be merged to **master** and tagged as the next major release. After the release is tagged, the **release-{milestone}** branch will also be merged back into **develop** and then the release branch will be removed. Java Runtime Requirement ------------------------------------ @@ -25,8 +46,13 @@ Gitblit requires at Java 7 Runtime Environment (JRE) or a Java 7 Development Kit Getting help ------------ -Read the online documentation available at the [Gitblit website](http://gitblit.com) -Issues, binaries, & sources @ [Google Code](http://code.google.com/p/gitblit) +| Source | Location | +| ------------- |--------------------------------------------------------| +| Documentation | [Gitblit website](http://gitblit.com) | +| Issues | [Google Code](http://code.google.com/p/gitblit) | +| Forums | [Google Groups](https://groups.google.com/forum/#!forum/gitblit) | +| Twitter | @gitblit or @jamesmoger | +| Google+ | +gitblit or +jamesmoger | Building Gitblit ---------------- @@ -49,3 +75,7 @@ Building Tips & Tricks ---------------------- 1. If you are running Ant from an ANSI-capable console, consider setting the `MX_COLOR` environment variable before executing Ant.
set MX_COLOR=true
2. The build script will honor your Maven proxy settings. If you need to fine-tune this, please review the [settings.moxie](http://gitblit.github.io/moxie/settings.html) documentation. + +[1]: http://nvie.com/posts/a-successful-git-branching-model +[2]: http://gitblit.com/tickets_overview.html +[3]: https://dev.gitblit.com diff --git a/src/site/features.mkd b/src/site/features.mkd index 9aa81962..d9ceba71 100644 --- a/src/site/features.mkd +++ b/src/site/features.mkd @@ -60,17 +60,18 @@ - Customizable regular expression substitution for commit messages (i.e. bug or code review link integration) - Single text file for users configuration - Translations - - English - - Japanese - - Spanish - - Polish - - Korean - - Brazilian Portuguese - - Dutch + - German (de) + - English (en) + - Spanish (es) + - French (fr) + - Italian (it) + - Japanese (ja) + - Korean (ko) + - Dutch (nl) + - Norwegian (no) + - Polish (pl) + - Brazilian Portuguese (pt_BR) - Simplified Chinese (zh_CN) - - French - - German - - Norwegian ## Gitblit GO Features - Out-of-the-box integrated stack requiring minimal configuration -- 2.39.5