Fix flow such that readers will follow easily - prerequisites (e.g. install docker, java, maven etc) - env setup first before endpoints - fix typos (e.g. docket in getting started)