OpenAPI Spec 3.0 based JSDoc modification

[pi1814]

What does this PR do?

Fixes # (issue)

Type of change

• Updated dependencies
• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How should this be tested?

• Existing unit tests

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code and corrected any misspellings
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[deepakprabhakara]

@pi1814 LGTM once website swagger gen is tested

[pi1814]

@pi1814 LGTM once website swagger gen is tested

Checked with website swagger gen locally.