diff --git a/README.md b/README.md
index 57e05d2..bfa7183 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
-# expandCIDR
+expandCIDR will use an nmap compliant scope list file and expand it, generating a file with the IP list.
 
-expandCIDR will use an nmap compliant scope list file and expand it, generating a file with the IP list.
-
-Optionally it can also select an arbitrary number of random IPs from the expanded IP list, instead. 
\ No newline at end of file
+Optionally it can also select an arbitrary number of random IPs from the expanded IP list, instead. Typically useful in large vulnerability assessments where a sample of a baselined subnet (such as SIP) is more efficient than testing the entire subnet.
+
+usage: expandcidr [scope file] [output file] {# of rnd ips}
+
+examples: expandcidr scope_subnets.txt scope.txt
+
+          expandcidr scope.txt sample.txt 500