added documentation + cleaned up json