From 3f0642eef1795df5809eff6b439b6f17c4b6c0bf Mon Sep 17 00:00:00 2001
From: Kimberly Garmoe <kgarmoe@chef.io>
Date: Thu, 8 Feb 2018 13:42:51 -0800
Subject: [PATCH] Refactors inetd_conf doc (#2543)

Signed-off-by: kagarmoe <kgarmoe@chef.io>
---
 docs/resources/inetd_conf.md.erb | 45 ++++++++++++++++++++------------
 1 file changed, 28 insertions(+), 17 deletions(-)

diff --git a/docs/resources/inetd_conf.md.erb b/docs/resources/inetd_conf.md.erb
index 41bb251ad..5e8d4af3f 100644
--- a/docs/resources/inetd_conf.md.erb
+++ b/docs/resources/inetd_conf.md.erb
@@ -24,10 +24,36 @@ where
 
 <br>
 
+## Supported Resource Properties
+
+This resource supports any of the properties listed as services in the `inetd.conf` file. You may want to ensure that specific services do not listen via `inetd.conf`.
+
+<br>
+
 ## Examples
 
 The following examples show how to use this InSpec audit resource.
 
+### Basic tests for inetd_conf services:
+
+    its('shell') { should eq nil }
+
+or:
+
+    its('netstat') { should eq nil }
+
+or:
+
+    its('systat') { should eq nil }
+
+For example:
+
+    describe inetd_conf do
+      its('shell') { should eq nil }
+      its('login') { should eq nil }
+      its('exec') { should eq nil }
+    end
+
 ### Verify that FTP is disabled
 
 The contents if the `inetd.conf` file contain the following:
@@ -63,22 +89,7 @@ then the same test will return `false` for `ftp` and the entire test will fail.
 
 ## Matchers
 
-This resource matches any service that is listed in the `inetd.conf` file. You may want to ensure that specific services do not listen via `inetd.conf`. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+ 
 
-    its('shell') { should eq nil }
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
 
-or:
-
-    its('netstat') { should eq nil }
-
-or:
-
-    its('systat') { should eq nil }
-
-For example:
-
-    describe inetd_conf do
-      its('shell') { should eq nil }
-      its('login') { should eq nil }
-      its('exec') { should eq nil }
-    end