Improve WDL documentation

[adamnovak]

This will hopefully fix #4631.

Still missing is a substantial worked tutorial for WDL, like we have for Python. But I've re-organized the docs and changed some words around to make Toil Python less the default.

Changelog Entry

To be copied to the draft changelog by merger:

• Warnings in the Toil documentation build (due to docstrings Sphinx can't understand) will now fail CI.
• Docstrings have been fixed to be parseable by Sphinx.
• The Toil documentation now emphasizes CWL and WDL usage.

Reviewer Checklist

• Make sure it is coming from issues/XXXX-fix-the-thing in the Toil repo, or from an external repo.
  • If it is coming from an external repo, make sure to pull it in for CI with:

    contrib/admin/test-pr otheruser theirbranchname issues/XXXX-fix-the-thing
    

  • If there is no associated issue, create one.
• Read through the code changes. Make sure that it doesn't have:
  • Addition of trailing whitespace.
  • New variable or member names in camelCase that want to be in snake_case.
  • New functions without type hints.
  • New functions or classes without informative docstrings.
  • Changes to semantics not reflected in the relevant docstrings.
  • New or changed command line options for Toil workflows that are not reflected in docs/running/{cliOptions,cwl,wdl}.rst
  • New features without tests.
• Comment on the lines of code where problems exist with a review comment. You can shift-click the line numbers in the diff to select multiple lines.
• Finish the review with an overall description of your opinion.

Merger Checklist

• Make sure the PR passes tests.
• Make sure the PR has been reviewed since its last modification. If not, review it.
• Merge with the Github "Squash and merge" feature.
  • If there are multiple authors' commits, add Co-authored-by to give credit to all contributing authors.
• Copy its recommended changelog entry to the Draft Changelog.
• Append the issue number in parentheses to the changelog entry.

[adamnovak]

I still need to add something about the conformance tests to this to fulfill the brief. I don't actually need a worked WDL tutorial probably.

[adamnovak]

Looks like I accidentally made this from my fork; if we have to bump the branch we also have to put the commits on issues/4631-improve-wdl-docs in this repo to test them.

[adamnovak]

I closed this out since I needed to update it and I made it from the wrong branch anyway.