DOC: fix docstring for design functions

And change mutable list default arguments to tuples.
DOC: more design docstring fixes

Some typos; change wording for default arguments.
Merge pull request #289 from matthew-brett/design-docstring-edits

DOC: fix docstring for design functions

And change mutable list default arguments to tuples.