Add Tokens example workflows page

[andreas-kupries]

Fixes #1630

Reminders

• See the README for more details on how to work with the Rancher docs.

• Verify if changes pertain to other versions of Rancher. If they do, finalize the edits on one version of the page, then apply the edits to the other versions.

• If the pull request is dependent on an upcoming release, remember to add a "MERGE ON RELEASE" label and set the proper milestone.

Description

Add an example workflows page for the new Imperative API resource Tokens that is coming with Rancher v2.12.0.

Comments

[pmkovar]

Thanks for the PR.

[sunilarjun]

Hello @andreas-kupries thank you for the page addition! I've left some review comments addressing some style/contents, and also are you able to rebase and add these changes to the v2.12 versioned_docs folder?

Additionally, the sidebars.js and versioned_sidebars/version-2.12-sidebars.json files need to be updated in order for the page to display and be clickable from the left navigation. Essentially "api/workflows/tokens" needs to be added to the sidebars.js file at line 1360, and similarly in the versioned_sidebars/version-2.12-sidebars.json file.

Please let me know if you need any help and I can definitely assist in updating the sidebars files as well, thanks!

[andreas-kupries]

Hello @andreas-kupries thank you for the page addition! I've left some review comments addressing some style/contents,

Accepted.

and also are you able to rebase and add these changes to the v2.12 versioned_docs folder?

Rebased to main now, and done the 2.12 changes, including the sidebars mentioned below.

Commit 4cd310a

Additionally, the sidebars.js and versioned_sidebars/version-2.12-sidebars.json files need to be updated in order for the page to display and be clickable from the left navigation. Essentially "api/workflows/tokens" needs to be added to the sidebars.js file at line 1360, and similarly in the versioned_sidebars/version-2.12-sidebars.json file.

Please let me know if you need any help and I can definitely assist in updating the sidebars files as well, thanks!

[LucasSaintarbor]

Removed an extra space and changed the H4s to H2s so they show up the right side nav and align with Projects page.

[sunilarjun]

Approving wrt my changes being addressed, thank you!

[LucasSaintarbor]

@andreas-kupries Requesting some grammar/style changes. Thanks!

[andreas-kupries]

Latest comments addressed. Also rebased to resolve conflict with kubeconfig work.

[LucasSaintarbor]

@andreas-kupries Thanks for applying the changes! LGTM.

[LucasSaintarbor]

@andreas-kupries Should not have approved just yet, to clean up the commit history, may you rebase against the https://github.com/rancher/rancher-docs/tree/v2.12.0 branch instead of main?

The base branch was changed.

[LucasSaintarbor]

@andreas-kupries Should not have approved just yet, to clean up the commit history, may you rebase against the https://github.com/rancher/rancher-docs/tree/v2.12.0 branch instead of main?

@andreas-kupries No need to rebase @btat took care of it.

[andreas-kupries]

@andreas-kupries Should not have approved just yet, to clean up the commit history, may you rebase against the https://github.com/rancher/rancher-docs/tree/v2.12.0 branch instead of main?

@andreas-kupries No need to rebase @btat took care of it.

After first reading the above I thought that I had rebased to 2.12 in my latest push.
Then I realized that it was maybe the base branch of the PR which was wrong, i.e. while the PR was structurally on 2.12 it compared to main instead of 2.12. This I had not checked for. So thanks for fixing that.