Reintroduce OpenAPI v3.2 Specification - with version selector

[Polo2]

Reverts #403, re-revert #329

Squashed in a single commit (we don't want 20 revert revert commits)

Old commits list:

• "oas: default example was wrong""
• "copy oas 3.1 with oas 3.2 changes""
• "more about tag kind and parent""
• "security scheme deprecation""
• "response description is optional""
• "response no content means no content""
• "security schemes can be references now too""
• "removed trailing slash""
• "use newer rfc relative ref pointer links""
• "more about tags, oauth2, and server names""
• "guide: pagination""
• "quick punt at streaming""
• "fix broken link""
• "improved json streaming guide""
• "new and improved json streaming guide""
• "couple more tweaks""
• "link to new spec""

WIP: add a version selector to switch between version 3.1 and 3.2.
Currently, only current version is displayed (thanks to #405 )

[netlify]

✅ Deploy Preview for bump-content-hub ready!

Name	Link
🔨 Latest commit	2599af6
🔍 Latest deploy log	https://app.netlify.com/projects/bump-content-hub/deploys/68df9a62e6d0590008d7feef
😎 Deploy Preview	https://deploy-preview-406--bump-content-hub.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[philsturgeon]

Sorry for all those commit names, I am used to doing Squash Merges so didn't think I'd be littering your inbox. I'll squash on my end next time.

[Polo2]

Sorry for all those commit names, I am used to doing Squash Merges so didn't think I'd be littering your inbox. I'll squash on my end next time.

Don't worry Phil it was easy to handle this big squash, and have a fresh base to handle the version select

[Polo2]

Cc @jayk-u , as discussed, I started a basic dropdown behavior, to allow navigation between versions only when pages exists.

for example:

this page exits on v3.2 only, the selector can not redirect to v3.1
https://deploy-preview-406--bump-content-hub.netlify.app/guides/openapi/specification/v3.2/advanced/json-streaming/

this page exits in both v3.1 and v3.2, the selector handles redirection
https://deploy-preview-406--bump-content-hub.netlify.app/guides/openapi/specification/v3.2/understanding-structure/basic-structure/

Can you confirm this is how you wanted it?

[jayk-u]

@Polo2 Absolutely, that’s exactly what I needed, thank you!
Can I start working on this PR to add the canonical link where needed?

[Polo2]

Can I start working on this PR to add the canonical link where needed?

I don't see any valuable reason to update this "src/_guides/openapi/specification/v3.1" folder to improve the dropdown component, so yes, you're free to add canonical 🛶 🇳🇮 urls to all these files.

As discussed, please favor a single commit for all these changes, since we still have to improve the code (what is it about my CSS?)

[jayk-u]

As requested, I added the canonical_url and updated the dates when necessary in a single commit.
The addition of a canonical_url was decided based on the following criteria:

• if the content was slightly modified or not modified at all, a canonical_url was added
• if the content was heavily modified, no canonical_url was added
• all canonical_url entries point to version 3.2 in order to favor its indexing.

Is this how you needed it @Polo2 ?

[Polo2]

As requested, I added the canonical_url and updated the dates when necessary in a single commit. The addition of a canonical_url was decided based on the following criteria:

• if the content was slightly modified or not modified at all, a canonical_url was added
• if the content was heavily modified, no canonical_url was added
• all canonical_url entries point to version 3.2 in order to favor its indexing.

Is this how you needed it @Polo2 ?

Yes, exactly!

I've got two small feedbacks with these canonical_urls:

• I noticed a small bug, HTML tag is duplicated, fixed in dedicated PR SEO: fix canonical_url duplication #410
• you have specified raw url, for example https://docs.bump.sh/guides/openapi/specification/v3.2/introduction/what-is-openapi/. Which mean we'll have to update all these data if we decide to change help center url ( move back to https://bump.sh for example). It's better if we are several people to have this in mind, right 😅

Beside that, LGTM.

[paulRbr]

👍 thanks for this nice improvement

[AurelDbs]

I have made changes to Polo's dropdown CSS.
It behaves in the same way as the branch dropdown in the app.
I just reduced the padding a little so that it wouldn't be too big, given how small the text is.