diff --git a/README.markdown b/README.markdown
index 22cce1e1..0cc7e81e 100644
--- a/README.markdown
+++ b/README.markdown
@@ -46,9 +46,11 @@ correctly the following should work:
     go get github.com/miekg/dns
     go build dns
 
-Sample programs can be found in the `ex` directory. They can 
-also be build with: `go build`.
-
+A short "how to use the API" is at the beginning of dns.go (this also will show
+when you call `go doc github.com/miekg/dns`. Sample
+programs can be found in the `ex` directory. They can also be build
+with: `go build`.
+ 
 ## Supported RFCs
 
 *all of them*