Products endpoint doc update

[alexdunnjpl]

🗒️ Summary

Trivial swagger doc update - /products only touches the latest-versioned products, yeah @jordanpadams ?

Applicable requirements

Refs #426

[jordanpadams]

@alexdunnjpl I updated the PR to include the requirement. I also updated the requirement success criteria to include more detailed information. all related requirements regarding versioning should be here in the parent theme:

• Implement expected latest and all functionality for all endpoints #428

[jordanpadams]

@alexdunnjpl @tloubrieu-jpl do we think we need separate requirements for each endpoint? or does #426 requirement suffice? In case it is the latter, I will add more success criteria, or I will create some more requirements.

[tloubrieu-jpl]

@jordanpadams @alexdunnjpl if we eventually have one test per requirement we should have one requirement per end-point. That would simplify the verification of the coverage of the test. But there might be a smarter way to do that...

[tloubrieu-jpl]

And @alexdunnjpl , we want to add an attribute all-versions at some point, soon, so we will have to change that documentation again.

[tloubrieu-jpl]

Thanks @alexdunnjpl

[jordanpadams]

@jordanpadams @alexdunnjpl if we eventually have one test per requirement we should have one requirement per end-point. That would simplify the verification of the coverage of the test. But there might be a smarter way to do that...

@tloubrieu-jpl +1 will break tout all the requirements.