V3 content

[itowlson]

This branch tracks work on Spin 3 updates. Initially it's a clone of the Spin 2 docs but this is where we will add / remove / tweak for the v3 stuff.

Content must go through a pre-merge checklist.

Pre-Merge Content Checklist

This documentation has been checked to ensure that:

• [ ] The title, template, and date are all set
• [ ] Does this PR have a new menu item (anywhere in templates/*.hbs files) that points to a document .md that is set to publish in the future? If so please only publish the .md and .hbs changes in real-time (otherwise there will be a menu item pointing to a .md file that does not exist)
• [ ] File does not use CRLF, but uses plain LF (hint: use cat -ve <filename> | grep $'\r' | wc -l and expect 0 as a result)
• [ ] Has passed bart check
• [ ] Has been manually tested by running in Spin/Bartholomew (hint: use PREVIEW_MODE=1 and run npm run styles to update styling)
• [ ] Headings are using Title Case
• [ ] Code blocks have the programming language set to properly highlight syntax and the proper copy directive
• [ ] Have tested with npm run test and resolved all errors
• [ ] Relates to an existing (potentially outdated) blog article? If so please add URL in blog to point to this content.

[github-actions[bot]]

🚀 preview deployed successfully to Fermyon Cloud and available at https://fermyon-developer-pr-1392-xcy9wthx.fermyon.app

[itowlson]

@karthik2804 I had to update some logic in page_lang.hbs and spin_main.hbs to tell it to use the v3 sidebar, but I couldn't figure out how to do the if ... else if ... else ... required to handle v3, v2 and v1. Can you advise please? (See https://github.com/fermyon/developer/pull/1392/commits/8dd50f8c532f707a7274d715c32fddbfd1108a1c for the crimes.)

[karthik2804]

@itowlson I opened a PR for that.

[itowlson]

Is there a way to know why preview deployment is failing? All the logs say is Internal Server Error.

[vdice]

Are we continuing the tradition of a cli reference? If so, do we want to add to this PR? Or a follow-up? There is a toolkit that should help with scaffolding it out: https://github.com/fermyon/developer/tree/main/toolkit

[itowlson]

No, I want to try getting rid of the CLI reference in its current format because it's laborious to maintain and doesn't seem to add much value. I'd maybe like to add a page that lists the commands and links to the other docs pages that cover them, which will be more stable and I feel more useful. But I can land that in a later PR.