Objects documentation outdated

[Heilemann]

As far as I can tell the objects documentation is outdated. I wrote a typescript interface based on it, but it didn't match the results I was getting from the roller.

Consider this a vote also cast for #94.