git-diff: rework a bit for clarity (#1129)

- use {{commit}} instead of {{PATHSPEC}}
- start with the simplest invocation, git diff
- move command to show staged changes next to the first two, which it is related to
- clarify description of --summary example
- move the .patch extension out of the token

pages/common/git-diff.md

@@ -2,22 +2,26 @@
 
 > Show changes to tracked files.
 
-- Show changes to tracked files:
+- Show unstaged, uncommitted changes:
 
-`git diff {{PATHSPEC}}`
+`git diff`
 
-- Show only names of changed files:
+- Show all uncommitted changes (including staged ones):
 
-`git diff --name-only {{PATHSPEC}}`
+`git diff HEAD`
 
-- Output a condensed summary of extended header information:
+- Show only staged (added, but not yet committed) changes:
 
-`git diff --summary {{PATHSPEC}}`
+`git diff --staged`
 
-- Show staged (added, but not yet committed) changes only:
+- Show only names of changed files since a given commit:
 
-`git diff --staged`
+`git diff --name-only {{commit}}`
+
+- Output a summary of file creations, renames and mode changes since a given commit:
+
+`git diff --summary {{commit}}`
 
 - Create a patch file:
 
-`git diff > {{target_file.patch}}`
+`git diff > {{target_file}}.patch`