Mc - docstring edits

I think the optimization comment belongs in the other function, doesn't it? I also edited it a bit and gave an example. See what you think.