WIP documentation audit

We're doing an audit of the API documentation in preparation for a 1.0 release. The minimum goal is that any documentation is verified correct. A stretch goal is the ensure that every part of the public API has:
 
  * premable blocks describing the major parts of the framework and their use (see `Em.Application`'s docs) 
  * each public method has a description and example use

If you'd like to help claim _a file (just one)_ in the comments below. It's yours for 24 hours. Then submit a PR against 
https://github.com/trek/ember.js/tree/api-documentation-audit when I merge your commit, I'll check it off the list.

Giant list outputted by `ls`:

- [x] container/lib/main.js
- [x] ember-application/lib/ext.js
- [x] ember-application/lib/main.js
- [x] ember-application/lib/system.js
- [x] ember-debug/lib/main.js
- [x] ember-handlebars-compiler/lib/main.js
- [x] ember-handlebars/lib/controls.js
- [x] ember-handlebars/lib/ext.js
- [x] ember-handlebars/lib/helpers.js
- [x] ember-handlebars/lib/loader.js
- [x] ember-handlebars/lib/main.js
- [x] ember-handlebars/lib/string.js
- [x] ember-handlebars/lib/views.js
- [x] ember-metal/lib/array.js
- [x] ember-metal/lib/binding.js
- [x] ember-metal/lib/chains.js
- [x] ember-metal/lib/computed.js
- [x] ember-metal/lib/core.js
- [x] ember-metal/lib/enumerable_utils.js
- [x] ember-metal/lib/events.js
- [x] ember-metal/lib/instrumentation.js
- [x] ember-metal/lib/main.js
- [x] ember-metal/lib/map.js
- [x] ember-metal/lib/mixin.js
- [ ] ember-metal/lib/observer.js @ebryn?
- [ ] ember-metal/lib/observer_set.js @ebryn?
- [x] ember-metal/lib/platform.js
- [x] ember-metal/lib/properties.js
- [x] ember-metal/lib/property_events.js
- [x] ember-metal/lib/property_get.js
- [x] ember-metal/lib/property_set.js
- [ ] ember-metal/lib/run_loop.js @ebryn 
- [x] ember-metal/lib/set_properties.js
- [x] ember-metal/lib/utils.js
- [ ] ember-metal/lib/watch_key.js @ebryn?
- [ ] ember-metal/lib/watch_path.js @ebryn?
- [x] ember-metal/lib/watching.js
- [x] ember-routing/lib/ext.js
- [x] ember-routing/lib/helpers.js
- [x] ember-routing/lib/location.js
- [x] ember-routing/lib/main.js
- [x] ember-routing/lib/system.js
- [x] ember-runtime/lib/controllers.js
- [x] ember-runtime/lib/core.js
- [x] ember-runtime/lib/ext.js
- [x] ember-runtime/lib/main.js
- [x] ember-runtime/lib/mixins.js
- [x] ember-runtime/lib/system.js
- [x] ember-states/lib/main.js
- [x] ember-states/lib/state.js
- [x] ember-states/lib/state_manager.js
- [x] ember-testing/lib/adapters.js
- [x] ember-testing/lib/helpers.js
- [x] ember-testing/lib/main.js
- [x] ember-testing/lib/support.js
- [x] ember-testing/lib/test.js
- [x] ember-views/lib/core.js
- [x] ember-views/lib/main.js
- [x] ember-views/lib/mixins.js
- [x] ember-views/lib/system.js
- [x] ember-views/lib/views.js
- [x] ember/lib/main.js
- [x] loader/lib/main.js
- [x] metamorph/lib/main.js
- [x] rsvp/lib/main.js

    ember-application/lib/ext:
- [x] controller.js

    ember-application/lib/system:
- [x] application.js
- [x] dag.js
- [x] resolver.js

    ember-handlebars/lib/controls:
- [x] button.js
- [x] checkbox.js
- [x] select.js
- [x] text_area.js
- [x] text_field.js
- [x] text_support.js

    ember-handlebars/lib/helpers:
- [x] binding.js
- [x] collection.js
- [x] debug.js
- [x] each.js
- [x] loc.js
- [x] partial.js
- [x] shared.js
- [x] template.js
- [x] unbound.js
- [x] view.js
- [x] yield.js @trek needs to mention component use

    ember-handlebars/lib/views:
- [x] handlebars_bound_view.js
- [x] metamorph_view.js

    ember-metal/lib/vendor:
- [x] backburner.js

    ember-routing/lib/ext:
- [x] controller.js
- [x] view.js

    ember-routing/lib/helpers:
- [x] action.js
- [x] control.js
- [x] link_to.js
- [x] outlet.js
- [x] render.js
- [x] shared.js

    ember-routing/lib/location:
- [x] api.js
- [x] hash_location.js
- [x] history_location.js
- [x] none_location.js

    ember-routing/lib/system:
- [x] controller_for.js
- [x] dsl.js
- [ ] route.js
- [ ] router.js

    ember-routing/lib/vendor:
- [x] route-recognizer.js
- [ ] router.js

    ember-runtime/lib/controllers:
- [ ] array_controller.js @trek needs rewrite
- [ ] controller.js @trek needs rewrite
- [ ] object_controller.js @trek needs rewrite

    ember-runtime/lib/ext:
- [x] ember.js
- [x] function.js
- [x] string.js

    ember-runtime/lib/mixins:
- [x] array.js
- [x] comparable.js
- [x] copyable.js
- [x] deferred.js
- [x] enumerable.js
- [x] evented.js
- [x] freezable.js
- [x] mutable_array.js
- [x] mutable_enumerable.js
- [x] observable.js
- [x] sortable.js
- [x] target_action_support.js

    ember-runtime/lib/system:
- [x] application.js
- [x] array_proxy.js
- [x] container.js
- [x] core_object.js
- [x] deferred.js
- [x] each_proxy.js
- [x] lazy_load.js
- [x] namespace.js
- [x] native_array.js
- [x] object.js
- [x] object_proxy.js
- [x] set.js
- [x] string.js

    ember-views/lib/mixins:
- [x] view_target_action_support.js
    ember-views/lib/system
- [x] controller.js
- [x] event_dispatcher.js
- [x] ext.js
- [x] jquery_ext.js
- [x] render_buffer.js
- [x] utils.js

    ember-views/lib/views:
- [x] collection_view.js
- [x] component.js
- [x] container_view.js
- [x] states
- [x] states.js
- [x] view.js