doc: grammatical revisions to core/spelling/__init__.py

Small revisions. Also moved some explanation of the return value from the 'parameters' section to the function description as I think return values should be covered by the function documentation itself..