add docs for takes_instance_or_queryset
tweak format of limitations section of readme