json parameter + readme update