refining documentation