improved json and readme