1 files changed, 38 insertions, 4 deletions
diff --git a/README.GIT b/README.GIT
index 654f2f990..65c5312e3 100644
--- a/README.GIT
+++ b/README.GIT
@@ -1,15 +1,25 @@
-(if this doesn't belong at the root of tde-packaging, feel free to move it to
-opensuse/ for reference.)
+============================================================ DOCUMENTATION =======================================================
+
+GIT tutorial on kernel.org:
+http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html
+
+GIT "cheat sheet"
+http://jonas.nitro.dk/git/quick-reference.html
+
+GIT for those who are used to centralized SCMs:
+http://media.pragprog.com/titles/tsgit/chap-005-extract.html
+
+================================================================ HOWTO ===========================================================
 
 To get a copy of the repo:
-	git clone <repository URL>
+	git clone http://your-username@scm.trinitydesktop.org/scm/git/<repository name>
 
 To exclude items:
 	Create a file '.gitignore'
 
 To add to the git repository (easiest and most efficient way):
 	git add .
-(this will add everything in the folder (excluding stuff from .gitignore).)
+(this will add everything in the folder (excluding stuff from .gitignore). It is intentionally a period because * will make git ignore already committed files.)
 
 To commit to the git repository (this does not send to the remote server!):
 	git commit -a
@@ -39,3 +49,27 @@ To tag a commit WITH GPG verification (secure release anyone?):
 	git tag -s <version> -m <message>
 
 
+
+================================================================= NOTE ============================================================
+GIT cannot store empty directories due to a intentional design limitation.
+
+Therefore, this command should be run prior to any commits to ensure your empty directories stick around:
+
+find . -type d -empty -exec touch {}/.gitignore \;
+
+This will add a .gitignore to every empty directory.
+
+================================================================ WORKFLOW ==========================================================
+
+
+git clone http://your-username@scm.trinitydesktop.org/scm/git/<repository>
+
+<make your changes, test, etc>
+
+cd <repository checkout directory>
+find . -type d -empty -exec touch {}/.gitignore \;
+git add .
+git commit -a
+git pull
+git push
+