cityscapelab, full document, perfection

documented everything and i think it is perfect, maybe not with
efficiency though