Merge pull request #1432 from swcarpentry/bkmgit-patch-2

Move callout on long vs short options

episodes/02-filedir.md

@@ -263,6 +263,18 @@ Mandatory arguments to long options are mandatory for short options, too.
 
 :::::::::::::::::::::::::::::::::::::::::  callout
 
+### When to use short or long options
+When options exist as both short and long options:
+
+- Use the short option when typing commands directly into the
+   shell to minimize keystrokes and get your task done faster.
+- Use the long option in scripts to provide clarity.
+  It will be read many times and typed once.
+
+::::::::::::::::::::::::::::::::::::::::::::::::::
+
+:::::::::::::::::::::::::::::::::::::::::  callout
+
 ## Unsupported command-line options
 
 If you try to use an option that is not supported, `ls` and other commands
@@ -833,18 +845,6 @@ Library/              Users/
 Network/              Volumes/
 ```
 
-
-:::::::::::::::::::::::::::::::::::::::::  callout
-### When to use short or long options
-When options exist as both short and long options:
-
-- Use the short option when typing commands directly into the
-   shell to minimize keystrokes and get your task done faster.
-- Use the long option in scripts to provide clarity.
-  It will be read many times and typed once.
-
-::::::::::::::::::::::::::::::::::::::::::::::::::
-
 ### Nelle's Pipeline: Organizing Files
 
 Knowing this much about files and directories,