minor refactor of render(), doc updates