Are the tutorials still part of the docs?

[itowlson]

We appear to have a number of tutorial pages (e.g. https://github.com/spinframework/spin-docs/blob/main/content/v3/key-value-store-tutorial.md) which as far as I can see are not linked from the sidebar. Am I missing something?

If they are no longer meant to be linked then I'd like to delete them for v4 so I don't have to update them all to P3! (And if they are meant to be linked then we're probably going to need some resource to test the P3-ised versions once we have the P3 SDK!)

[vdice]

It looks like they are still commented out (removed in #39 with a placeholder to re-add in #40). This must've happened during the big docs revamp during migration into CNCF. I think we'd always intended to re-add them at a future date but we/I had forgotten.

I'd be glad to help, unless you are deep into docs re-work and would like to take this on. Can help as well with updating and testing the tutorials re: P3.

(edit: I tried to brute-force (re-)creation of a Tutorials section but it wasn't pretty; I'd likely need to pair with your and/or Karthik)

[vdice]

That being said, I'm guessing we'd want to also revisit the current tutorials and decide which we want to keep, drop, refresh and/or add to.

Another option? Migrate any of the set above to the Spin Hub (if a corollary doesn't already exist). Granted, here we'd be deviating from the original purpose of a tutorial (eg mostly a docs-lead building and running of a Spin app to highlight a feature) to a less docs-heavy example app scenario.

Then there's the (perhaps separate but related) topic of showcasing (or at least example-ing) P3-ized Spin apps. But maybe there's already a vision that doesn't involve Tutorials or Hub apps? Maybe they'd live in respective SDK repos? (In that case, would be great to surface these on the docs site somehow)

[itowlson]

Yeah I am not sure. It feels like they kind of made sense as part of the docs, so that we could walk people through the construction process (rather than presenting them with a finished product as Spin Hub tends to). But they certainly don't get well maintained, and are a bit of a random set based on what the original Fermyon folks wanted to show at the time (really a bit of "introduce the new feature with some code" I guess).

I'll toss them from v4 for now, but it would be great to rethink what we should have and how to present the different things.