docs: add explanation of modes