further refining documentation