doc: fix and clarify documentation for the `parse` function.