Docs updates

@zoni This should be right up your alley.
True. But it violates the Pythonic method of checking for an empty dict/tuple/list which is simply `if dict`.

But this works and is less horrible than everything else.