fix changes and use json representation in docs