doc: improving doc / readability
merge with doc/controller_done_rendering