Updating README to reflect recent changes

Author: ndabas

README.md

@@ -3,57 +3,65 @@
 A minimal, tiny jQuery plugin that will generate a table of contents, drawing from headings on the
 page.
 
-## Usage
+The generated TOCs are semantic, nested lists (`ul` or `ol`) with hash-link anchors to the headings.
 
-After including jQuery (>= 1.6) and jquery.toc.js on your page, run a script like this:
+## Usage
 
-    $("#toc").toc();
+Include jQuery (>= 1.6) and jquery.toc.js on your page. The plugin can then be used either via HTML5
+data attributes, or via the programmatic API.
 
-This will generate the TOC from all `h1`, `h2`, `h3`, and `h4` tags on the page, and insert it into
-`#toc` (for example, `<div id="toc"></div>`.) The list itself will use `ul` tags, and each heading
-on the page will get a nice ID, if it doesn't already have one. The IDs will be based on the text
-content of the heading.
+### Via data attributes
 
-### Options
+Minimal example:
 
-The plugin has two arguments, both optional:
+    <ul data-toc></ul>
 
-    $(...).toc(contentContainer, options);
+With options:
 
-`contentContainer` is a selector where the plugin will look for headings to build up the TOC.
+    <ol data-toc="div.container" data-toc-headings="h2,h3,h4"></ol>
 
-`options` is a hash, with these keys: (all optional)
+### Via the JavaScript programmatic API
 
-* `headings` is a string with a comma-separated list of selectors to be used as headings, in the
-  order which defines their relative heirarchy level. The default value of `"h1,h2,h3,h4"` will
-  select all `h1`, `h2`, `h3`, and `h4` to build the TOC, with `h1` being a level 1, `h2` a level 2,
-  and so on. You can use any valid list of jQuery selectors; for example, if you just want `h1` tags
-  with a specific class, and no `h4` tags, you could use `"h1.title,h2,h3"` for this option.
-* `list` is the tag that's created for the lists. Valid options are `"ul"` and `"ol"`.
+Minimal example:
 
-The default values are:
+    <ul id="toc"></ul>
+    ...
+    <script type="text/javascript">
+        $("#toc").toc();
+    </script>
 
-    $(...).toc("body", {headings: "h1,h2,h3,h4", list: "ul"});
+With options:
 
-### Examples of Usage
+    <ul id="toc"></ul>
+    ...
+    <script type="text/javascript">
+        $("#toc").toc("div.container", "h2,h3,h4");
+    </script>
 
-Build a TOC using headings from a specific container element:
+### Options
 
-    $("#toc").toc("#container");
+    <ul data-toc="contentContainer" data-toc-headings="headings"></ul>
 
-Build a TOC using specific kinds of headings:
+    $(...).toc(contentContainer, headings);
 
-    $("#toc").toc("body", {headings: "h2.title,h3"});
+The plugin has two parameters, both optional:
 
-Build a TOC using numbered lists:
+* `contentContainer` is a selector where the plugin will look for headings to build up the TOC. The
+  default value is `"body"`.
+* `headings` is a string with a comma-separated list of selectors to be used as headings, in the
+  order which defines their relative heirarchy level. The default value of `"h1,h2,h3,h4"` will
+  select all `h1`, `h2`, `h3`, and `h4` to build the TOC, with `h1` being a level 1, `h2` a level 2,
+  and so on. You can use any valid list of jQuery selectors; for example, if you just want `h1` tags
+  with a specific class, and no `h4` tags, you could use `"h1.title,h2,h3"` for this parameter.
 
-    $("#toc").toc("body", {list: "ol"});
+In addition, the plugin will create nested lists of the same type (`ul` or `ol`) as the element that
+it's called on.
 
 ### Automatic ID generation
 
 The plugin generates hash-links to the headings on the page, to allow users to jump to the heading
 by clicking in the generated table of contents. This feature requires that the headings have IDs
-assigned; if they do not, the plugin will generate IDs for you.
+assigned; if they do not, the plugin will generate and assign IDs automatically.
 
 The generated IDs are based on the text inside the headings, and uses two simple rules: