DEVDOCS-6104: Clarify the meaning of version field in the request/response of cart/checkout API

[davidchin]

DEVDOCS-6104

What changed?

• Clarify the meaning of version field in the request/response of cart/checkout API so developers know what it can be used for.

Release notes draft

N/A

ping @bigcommerce/team-checkout

[bc-traciporter]

Hi @Lucki2501 I made some editorial updates. I removed passive voice. Let me know if you think the changes are okay or if they change the meaning.

[bc-shawnwang]

it's good on the words itself, I'm just wondering if there is the way to extract this general field and every place just refer it.

[davidchin]

@bc-shawnwang Yeah I agree, I also notice there's a lot of duplication. I'll leave it to the dev-docs team to restructure the yaml files.

[bc-traciporter]

Thank you @bc-shawnwang, @valentindellangela and @animesh1987 . I would like to close this PR for now and think about how to better restructure this file to remove the duplication. I wasn't able to figure out how to do it quickly. I will need to think about it.

[bc-andreadao]

@bc-traciporter My PR 468 restructures the storefront checkout yml file, so that endpoint would be taken cared of

[bc-traciporter]

@bc-traciporter My PR 468 restructures the storefront checkout yml file, so that endpoint would be taken cared of

Awesome @bc-andreadao