Jimmyfagan/bb2 3569 update swagger docs

[jimmyfagan]

JIRA Ticket:
BB2-3569

What Does This PR Do?

This PR updates some of the swagger doc organization and details, especially around date type parameters.

What Should Reviewers Watch For?

If you're reviewing this PR, please check for these things in particular:
Does the new text make sense? Does the parameter behave as described?

Validation

Copy/pasted into https://editor.swagger.io/

What Security Implications Does This PR Have?

Please indicate if this PR does any of the following:

• Adds any new software dependencies
• Modifies any security controls
• Adds new transmission or storage of data
• Any other changes that could possibly affect security?

• Yes, one or more of the above security implications apply. This PR must not be merged without the ISSO or team
  security engineer's approval.

Any Migrations?

• Yes, there are migrations
  • The migrations should be run PRIOR to the code being deployed
  • The migrations should be run AFTER the code is deployed
  • There is a more complicated migration plan (downtime,
    etc)
• No migrations