DOC: typos
DOC optional -> optimal
DOC optional -> optimal
typos throughout the codebase
Merge pull request #3200 from argriffing/moretypos

MAINT: fix typos