docs and private ctors

- add some docs
- make some public ctors private, to reconcile with what the docs were saying
- add a `browser` dependency, which the test directory needs
- move the `doctype` to the top of the html file, to make some browsers happy

@justinfagnani