some documentation
less json..... ??