polishing + documentation