update: compute property values before render; update docs