--- a/docs/releases/notes08.html.markdown
+++ b/docs/releases/notes08.html.markdown
@@ -142,16 +142,18 @@ Let's take a closer look:
   that you create.
 * Once you have the editor object, you can use the what we call the _Editor API_
   to interact with it. You find the complete [API here][1].
   Many function calls in the 0.7 API have been replaced 
   with getters and setters in 0.8, which makes the code more readable. 
   Imagine you want to make the current selected text upper case. 
   Before, you had to write:
 
+How selected text replacement worked before:
+
     :::js
     // This holds the Bespin editor;
     var editor;
     // Make the current selected text upper case.
     editor.replaceSelection(editor.getSelectedText().toUpperCase());
 
 With the new _Editor API_ this changed to:
 
@@ -160,25 +162,29 @@ With the new _Editor API_ this changed t
     var editor;
     // Make the current selected text upper case.
     editor.selectedText = editor.selectedText.toUpperCase();
 
 * If you change the size of the Bespin container, you have to call the
   `dimensionsChanged` function, which is now on the `env` object. When the window
   resizes, this event is fired automatically:
 
+How to register a size change:
+
     :::js
     // Tell Bespin that the container size changed.
     env.dimensionsChanged();
 
 
 * You can still dynamically initialize Bespin on your page. The
   `bespin` property on the DOM node is now the `env` (environment) variable
   described above:
 
+Example of using the "env" variable from the DOM node:
+
     :::html
     <div id='edit' class='bespin'>Bespin editor goes here!</div>
 
     <script>
         // This function is called when all Bespin instances on the page were
         // initialized.
         //
         // Make sure you access the Bespin instance *AFTER* the window.onBespinLoad