-The <<Discussion>> section below contains much useful definition and
-clarification info - read that first. And of the commands, I suggest
-reading gitlink:git-update-index[1] and
-gitlink:git-read-tree[1] first - I wish I had!
+The <<Discussion>> section below contains much useful definition
+and clarification info - read that first. After that, if you
+are interested in using git to manage (version control)
+projects, read on commands listed in Porcelain-ish commands
+section next. On the other hand, if you are writing your own
+Porcelain, I suggest reading gitlink:git-update-index[1] and
+gitlink:git-read-tree[1] first.