add generated docs, to avoid user build dependency on ronn
minor README formatting