Suggested improvements to Object/Collection docs

Having comments at the top of the file means they don't appear in the api docs, so I've moved them down to the constructor so they appear at the top of the appropriate docs page.