Feature/procedural cleanup

[denis-yuen]

WIP with documentation update and some simple community recommended tickets

Addresses

• Clean-up and/or conversion issues from swagger 2.0 to openapi  #229
• documentation feedback from committee meeting #114

[denis-yuen]

Note to self: I also tried to fix the 2.0.1 documentation builds which seem troubled. It looks like documentation builds on tags as opposed to branches seems broken.

Looks possibly like ga4gh/gh-openapi-docs#43 but the fix is unreleased in the develop branch if I understand correctly. In the meantime, I created a branch https://github.com/ga4gh/tool-registry-service-schemas/tree/release-2.0.1 so that documentation for that release shows up in the documentation table of contents

[denis-yuen]

Note for self: need to put back swagger.json link in addition to openapi link to get both since we go "back in time" when generating a TOC