diff --git a/docs/resources/filesystem.md.erb b/docs/resources/filesystem.md.erb
index 27c921396..87f326f5f 100644
--- a/docs/resources/filesystem.md.erb
+++ b/docs/resources/filesystem.md.erb
@@ -4,7 +4,8 @@ title: About the filesystem Resource
 
 # filesystem
 
-Use the `filesystem` InSpec resource to audit filesystem disk space usage
+Use the `filesystem` InSpec resource to audit filesystem disk space usage.
+
 <br>
 
 ## Syntax
@@ -17,12 +18,12 @@ A `filesystem` resource block declares tests for disk space in a partion:
 
 where
 
-* `filesystem('/')` states that it will be looking at the root (/) partition
-* `size` is measured in megabytes (MB)
+* `filesystem('/')` states that the resource will look at the root (/) partition.
+* `size` is measured in megabytes (MB).
 
 <br>
 
-## Examples
+## Resource Property Examples
 
 The following examples show how to use this InSpec audit resource.