improved json documentation