improve docblocks for context configuration