its all about the time
[gwvp.git] / README
diff --git a/README b/README
new file mode 100644 (file)
index 0000000..ddc2292
--- /dev/null
+++ b/README
@@ -0,0 +1,40 @@
+GWVP
+====
+
+Git over Web Via PHP is a project to do something i've wanted to have a long time - a web based git remote 
+with administration and all git related activities happening over http/https. Git has this now, its called
+git-http-backend and its quite broken. If you read its man page it'll tell you this:
+
+               To enable anonymous read access but authenticated write access,
+           require authorization with a LocationMatch directive:
+
+               <LocationMatch "^/git/.*/git-receive-pack$">
+                       AuthType Basic
+                       AuthName "Git Access"
+                       Require group committers
+                       ...
+               </LocationMatch>
+
+This will never work in a month of sundays, but yet its been in the man page and been un-fixed now for a year
+and besides that i've decided i want a web based one. Im sick of git over ssh with ssh keys, its annoying
+when it can be done with user/password auth over https.
+
+Thats what the project is designed to do - give people the ability to administrate a set of a git repo's via
+a web interface and have the same web interface for pull and push.
+
+What you will ultimately be able to do is:
+1) get list of git repos (with an interface like gitweb)
+2) create users and assign permissions into repo's
+3) create repos
+4) import repos
+
+but most importantly:
+git add remote origin https://username@server/git/myrepo.git
+git push
+
+How it Works
+============
+Initially this thing will have a fairly boring interface for creating/contorlling users and repos while
+also pushing directly back to git-http-backend AND providing the authentication interface IT needs to function
+
+Gitweb.cgi may also be incorporated as the git view tool - but thats less important at this point
\ No newline at end of file