improve markers; update docs