Edited contents and fixed typos

Author: dafi

alignRules.md

@@ -10,7 +10,7 @@ subtitle: Change the default file names alignment method
 
 Before being compared two files they must be aligned, the alignment rule can be configured
 
-# Align by name case sensitivity
+# Align by Name Case Sensitivity
 
 The default alignment method compares file name strings, if they are match case then they will be aligned.  
 Suppose you have the scenario shown below
@@ -54,7 +54,7 @@ This can be achieved selecting 'Ignore File Name Case' from popup menu.</p>
 </tr>
 </table>
 
-# Align by HFS+ filesystem case
+# Align by HFS+ Filesystem Case
 
 Normally the <acronym title="Hierarchical File System">HFS+</acronym> disks are formatted ignoring the file name case, so if we have winter.jpg and WINTER.JPG they cannot be created on same directory (because they have the same name).
 
@@ -68,7 +68,7 @@ It is possible to let VisualDiffer determine the file name alignment case algori
 
 If the last scenario is true, the alignment will try to be smart, first it searches if a match case is available (winter.jpg with winter.jpg) then it tries to align with the most similar name.
 
-# Align by user defined rules (not available on OSX 10.6 Snow Leopard)
+# Align by User Defined Rules (required OSX Lion or above)
 
 There are scenarios where it is necessary to align files having different names.
 
@@ -115,15 +115,15 @@ Suppose you want to align ignoring the file extension to produce the result show
 
 This can be achieved using VisualDiffer 'user defined alignment rules'.
 
-## Managing alignment rules
+## Managing Alignment Rules
 
 You can create, edit or delte rules from Session Preferences Dialog
 
 ![image]({{ site.prefixDir }}images/screenshots/sessionPrefAlignment.png)
 
 More rules can be assigned to a VisualDiffer session comparison, they are evaluated from top to bottom.
 
-## Creating a rule
+## Creating a Rule
 
 When you add a new rule (or edit an existing one) you access to the dialog shown below
 
@@ -136,11 +136,11 @@ A rule has
 
 _If you are not familiar with regular expressions please refer to [ICU](http://userguide.icu-project.org/strings/regexp) documentation._
 
-## Left regular expression
+## Left Regular Expression
 
 The left regexp is used to match a filename on the left side of VisualDiffer Folder View, we want to find all jpg files so we create a group `(.*)` followed by `.jpg` extension.
 
-## Right pattern expression
+## Right Pattern Expression
 
 Notice the right expression **isn't** a regular expression, it should contain some special patterns used to access to regular expression groups (if any).
 
@@ -173,4 +173,5 @@ But `002.jpg` and `002.RAW` files are not aligned because `002.RAW` extension is
 ![image]({{ site.prefixDir }}images/screenshots/alignRuleIgnoreCase.png)
 
 ## Test Rule
-TODO
+
+It is possible to verify immediately if the expressions work as expected using the 'Test Rule', just type a file name and the 'Result' field will be filled accordingly.

comparisonMethods.md

@@ -4,11 +4,11 @@ layout: default
 
 # mainAnchor is used by Apple links
 mainAnchor: comparisonMethod
-title: Comparison method
-subtitle: Choose the method to compare folders and how to handle special files and metadata
+title: Comparison Method
+subtitle: The folders comparison method, special files and metadata
 ---
 
-# Comparison method
+# Comparison Method
 
 It is possible to choose which method to use to compare two folders.  
 The method to use is strictly related to user needs, comparing source code (files large only few kilobytes) should use a content comparison but to find which movies (files larger than a gigabytes) are not present on right side is faster compare by file size or file timestamp.
@@ -59,7 +59,7 @@ The complete list of supported comparison methods
 </table>
 
 
-# Compare Finder metadata
+# Compare Finder Metadata
 
 It is possible to compare OSX Finder Metadata.
 
@@ -84,7 +84,7 @@ The complete list of supported metadata
 </table>
 
 
-# Special files handling
+# Special Files Handling
 
 User can choose to not traverse special files like symbolic links and packages
 
@@ -105,7 +105,7 @@ User can choose to not traverse special files like symbolic links and packages
 </table>
 
 
-# Timestamp tolerance
+# Timestamp Tolerance
 
 The timestamp comparison considers two files matching when the time (including the seconds) is identical but sometime it would be useful to have a range of tolerance for example when the difference is between 5 seconds.
 
@@ -114,9 +114,9 @@ You can set this tolerance entering a positive integer number into the text fiel
 Ignore differences of X seconds or less 
 
 
-# File to show
+# Choose Files to View according to differences found
 
-After the comparison complete you can determine which files to show
+After the comparison complete you can choose which files to view
 
 Definition: **Orphan** indicates a file present only on one side
 

fileFilters.md

@@ -70,10 +70,10 @@ Pay attention to not add extra characters, the following paths will never found
 <strong>project_1/src/</strong>&nbsp;&nbsp;&nbsp;invalid, trailing slash  
 
 
-# File size Filters
+# File Size Filters
 
 It is possible to specify files (not folders) to exclude based on their size expressed in bytes, KB, MB and GB
 
-# File modification date Filters
+# File Modification Date Filters
 
 It is possible to specify files (not folders) to exclude based on their last modification date and time

finder.md

@@ -21,14 +21,14 @@ You don't need to run VisualDiffer then select items to compare, if you are on F
 
 Add to Finder context menu (under Services) a new menu item to allow files and folders comparison.
 
-## How to install
+## How to Install
 - On Lion or above double click on "Compare with VisualDiffer.workflow" file
 - On Snow Leopard you must copy manually the file "Compare with VisualDiffer.workflow" inside the directort /Users/your account 
 name/Library/Services. If the directory 'Services' doesn't exist you must create it
 
 More details about installation are available <a href="https://github.com/visualdiffer/scripts/blob/master/installServices.md">here</a>
 
-## How to use
+## How to Use
 
 - When elements to compare are both visible on Finder window simply select the two files or folders and choose "Compare with VisualDiffer" 
 from service menu

trustedPaths.md

@@ -25,7 +25,7 @@ Applications like Dreamweaver save to temporary file the remote version and then
 
 This behaviour generates a very frustrating user experience because the user must select the file from the panel again and again.
 
-Use trusted paths
+Use Trusted Paths
 =================
 
 Trusted paths resolve this problem, applications save files always on their own specific temporary folders, for example SourceTree can generate the following path
@@ -38,7 +38,7 @@ We can trust **/var/folders** that is the root used by SourceTree to saves tempo
 
 Trusting **/var/folders** ensures every path generated inside it (at any deeper subfolder level) doesn't require any additional user permission and the file panel prompts no longer appears
 
-Where configure trusted paths
+Where configure Trusted Paths
 =============================
 
 You can add and removed trusted paths from VisualDiffer Preference panel