diff --git a/browserid/static/css/style.css b/browserid/static/css/style.css
index 7ca81633f9045669e1cba40455b1bbc0ddf26d7a..3a2117c6e823120b6fe6e7a7558dcab2d91b3411 100644
--- a/browserid/static/css/style.css
+++ b/browserid/static/css/style.css
@@ -174,7 +174,7 @@ a:hover {
     font-size: 14px;
 }
 
-.bottomhalf .step > p {
+.bottomhalf .step > p, .bottomhalf .step > ol {
     margin-left: 50px;
 }
 
diff --git a/browserid/static/developers.html b/browserid/static/developers.html
index 53218eb829c44b42fb9f1932c779d8579d1425ca..f3569d18d127fb1793ec731de781fa177ca148c1 100644
--- a/browserid/static/developers.html
+++ b/browserid/static/developers.html
@@ -56,7 +56,7 @@
       </p>
       <p>
         <b>NOTE:</b> While completely optional, you might consider
-        replacing your login/signin button with a pretty browserid button:
+        replacing your login/signin button with a pretty BrowserID button:
         
         <div class="buttonbox">
           <div><img src="i/sign_in_red.png"></div>
@@ -76,9 +76,16 @@
         free verification service provided by BrowserID.
       </p><p>
         To use it, you send a request
-        to <tt>https://browserid.org/verify</tt> with the assertion as
-        a GET parameter.
-
+        to <tt>https://browserid.org/verify</tt> with two GET parameters:
+      </p>
+        <ol>
+          <li> <tt>assertion</tt>: The encoded assertion
+          <li> <tt>audience</tt>: The hostname and optional port of your site
+        </ol>
+      <p>
+        The verifier will check the the assertion was meant for your site and
+        is valid, here's an example:
+      </p>
         <pre><code>$ curl "https://browserid.org/verify?assertion=&lt;ASSERTION&gt;&audience=mysite.com"
 {
     "status": "okay",