Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I started making suggested changes to plural naming (to match existing methods) for the array cases but after many comments I decided pushing the changes up would be decidedly less annoying :)

This looks great - I tweaked docs and methods, only thing missing I think is testing on the singular methods.

Edit: we should also test the missing key cases (need not be different test methods) to ensure that behaves as expected - thought of this looking at another PR.