moar better docs for to_json; -spec