DOC: fix docstring for design functions

And change mutable list default arguments to tuples.