pattern docs: arrangement improved