From 16856603ec575718857768e2d18e455c95fd6ea4 Mon Sep 17 00:00:00 2001 From: James Moger <james.moger@gitblit.com> Date: Tue, 07 Jun 2011 19:08:24 -0400 Subject: [PATCH] Documentation. Moved clone and fetch into JGitUtils. Create bare only. --- docs/01_faq.mkd | 23 ++++++++++++++++++++++- 1 files changed, 22 insertions(+), 1 deletions(-) diff --git a/docs/01_faq.mkd b/docs/01_faq.mkd index 5068e79..a80e4e2 100644 --- a/docs/01_faq.mkd +++ b/docs/01_faq.mkd @@ -27,9 +27,29 @@ ### Why use Gitblit? It's a small tool that allows you to easily manage shared repositories and doesn't require alot of setup or git kung-foo. +### Who is the target user for Gitblit? +Small workgroups that require centralized repositories. + +Gitblit is not meant to be a social coding resource like [Github](http://github.com) or [Bitbucket](http://bitbucket.com) with 100s or 1000s of users. Gitblit is designed to fulfill the same function as your centralized Subversion or CVS server. + +### Why does Gitblit exist? +As a Java developer I prefer that as much of my tooling as possible is Java.<br/> +Originally, I was going to use [Mercurial](http://mercurial.selenic.com) but... + +- MercurialEclipse [shells to Python and captures System.in](http://mercurial.808500.n3.nabble.com/Hg4J-Mercurial-pure-Java-library-tp2693090p2694555.html)<br/> +Parsing command-line output is fragile and suboptimal.<br/>Unfortunately this is necessary because Mercurial is an application, not a library. +- Mercurial seems to [frown](http://mercurial.808500.n3.nabble.com/Hg4J-Mercurial-pure-Java-library-tp2693090p2695051.html) on the fledgling [Hg4j][hg4j] (pure Java Mercurial) project. +- Mercurial HTTP/HTTPS needs to run as CGI through Apache/IIS/etc, as mod_python through Apache, or served with a built-in http server.<br/> +This requires setup and maintenance of multiple, mixed 3rd party components. + +Gitblit eliminates all that complication with its 100% Java stack and simple single configuration file. + ### Do I need real Git? No. Gitblit is based on [JGit][jgit] which is a pure Java implementation of the [Git version control system][git].<br/> Everything you need for Gitblit is either in the zip distribution file or automatically downloaded on execution. + +### Can I run Gitblit in conjunction with my existing Git tooling? +Yes. You can configure Gitblit to only be a repository viewer. ### Do I need a JDK or can I use a JRE? Gitblit will run just fine with a JRE. Gitblit can optionally use `keytool` from the JDK to generate self-signed certificates, but normally Gitblit uses [BouncyCastle][bouncycastle] for that need. @@ -73,4 +93,5 @@ [jgit]: http://eclipse.org/jgit "Eclipse JGit Site" [git]: http://git-scm.com "Official Git Site" [mina]: http://mina.apache.org "Apache Mina" -[bouncycastle]: http://bouncycastle.org "The Legion of the Bouncy Castle" \ No newline at end of file +[bouncycastle]: http://bouncycastle.org "The Legion of the Bouncy Castle" +[hg4j]: http://code.google.com/p/hg4j/ "hg4j" \ No newline at end of file -- Gitblit v1.9.1