diff --git a/ripple.txt b/ripple.txt
index a573c3c01..1e3904e45 100644
--- a/ripple.txt
+++ b/ripple.txt
@@ -1,10 +1,8 @@
 #
 # Sample ripple.txt
 #
-# Publishing this file allows a site to declare in a trustworthy manor that
-# their node_public_key is the authorized signature for the domain. This does
-# not imply that a node serving the Newcoin protocol is avilable at the web
-# host providing the file.
+# Publishing this file allows a site to declare in a trustworthy manor ripple
+# associated information.
 #
 # This file is stored on the web server for a domain.  This file is searched
 # for in the following order:
@@ -17,9 +15,33 @@
 # Undefined sections are reserved.
 # No escapes are currently defined.
 #
+# [expires]
+#   Number of days after which this file should be considered expire.  Clients
+#   are expected to check this file when they have cause to believe it has
+#   changed or expired. For example, if a client discovers an account declares
+#   that it is associated with the domain, it should check to see if this file
+#   has been updated. If an expiration date is not declared, the default
+#   expiration for this file is 30 days.
+#
+#   Example: 30
+#
+# [accounts]
+#   Only valid in "ripple.txt". A list of accounts that are declared to be
+#   controlled by this domain. A client wishing to indicate that an account is
+#   verified as belonging to a domain will be show the account with a green
+#   background. A client can verify that an account belongs to a domain by
+#   checking if the account's root entry mentions the domain containing this
+#   file and this file found at the domain mentions the account in this
+#   section.
+#
+#   Example: rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn
+#
 # [validation_public_key]:
-#   Mandatory in "ripple.txt".
-#   Only valid in "ripple.txt".
+#   Only valid in "ripple.txt". A validation public key that is declared
+#   to be used by this domain for validating ledgers and that it is the
+#   authorized signature for the domain. This does not imply that a node
+#   serving the Ripple protocol is avilable at the web host providing the
+#   file.
 #
 #   Example: n9MZTnHe5D5Q2cgE8oV2usFwRqhUvEA8MwP5Mu1XVD6TxmssPRev
 #