aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2013-09-20 10:58:13 +0200
committerMattias Andrée <maandree@operamail.com>2013-09-20 10:58:13 +0200
commit97b18bb1831b5d165c3d9cb9b16ba3a4e3c4dcbf (patch)
tree02350313d1748ac9ac1005ab24321ab0019ba4e5 /README
parenttypo (diff)
downloadusing-git-97b18bb1831b5d165c3d9cb9b16ba3a4e3c4dcbf.tar.gz
using-git-97b18bb1831b5d165c3d9cb9b16ba3a4e3c4dcbf.tar.bz2
using-git-97b18bb1831b5d165c3d9cb9b16ba3a4e3c4dcbf.tar.xz
misc fixes
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to 'README')
-rw-r--r--README33
1 files changed, 20 insertions, 13 deletions
diff --git a/README b/README
index 5ea4624..00e3be5 100644
--- a/README
+++ b/README
@@ -1,25 +1,32 @@
In lack of good git documentation and manuals, I started by own.
It seems to be lack of well written manuals, and Git's online
-documention itself is atrocious. While I do not except the writers
-to have taking any course in pedagogy or didactics, or even have any
-practical experience, I at least expect the writters to try to
-keep those aspects in mind, but that does not seem to be the case.
+documention itself is atrocious. While I do not except the
+writers to have taking any course in pedagogy or didactics, or
+even have any practical experience, I at least expect the
+writters to try to keep those aspects in mind, but that does
+not seem to be the case.
-Documentation should first introduct the concept, then the
+Documentation should first introduce the concept, then the
implementation; that is, first how to get started, than what
-they are doing. In other words, first how to create a Git
+they are doing*. In other words, first how to create a Git
repository and the absolute essantials, than introduce Git
itself. Not first taking about what Git is, readers want to
read the chapters in their order, if they do not have anything
specific in mind.
-Documentation should then give you breif documentation of everthing
-you need to know in the order of imporantance, then, iterator be
-more advanced.
+Documentation should then give you breif a documentation of
+everything you need to know in the order of its imporantance,
+then, iterate to the more advanced.
-But one of the most important part is not to start with dangerous
-commands just because it is easier to be lazy them. Try to do it
-right from the beginning, otherwise the wrong way will stick in
-the reader's memory.
+But one of the most important part is not to start with
+dangerous commands just because it is easier to be lazy them.
+Try to do it right from the beginning, otherwise the wrong
+way will stick in the reader's memory.
+
+
+
+* This is a concept called ‘concrete before abstract’. While I
+ disagree that it is always the best practices, I do thinks
+ in this case.