add docs for mode setting