Two types of tutorials, should be unified
While working on issues https://github.com/dapr/quickstarts/issues/1028 and https://github.com/dapr/docs/issues/3985, @marcduiker and I ran into the two types of tutorials in docs and in quickstarts, see https://docs.dapr.io/getting-started/tutorials/ This is confusing for the user, since once they enter one type of scenario, they can't easily navigate to the other type.
The tutorials in docs have the advantage of rich mark up with tabs and searchability. The tutorials in quickstarts have the advantage of text close to code.
The proposal part of this issue is open for discussion :-)
Our proposal is to
- move the tutorial's readme text from quickstarts to docs
- add a link in the quickstart tutorial readme to the new tutorial location in docs
- refactor the tutorial in their new location to make sure links work and to leverage docs capabilities like tabs
@pdebruin I can work on something like this, after 1.14 release. to clarify, essentially you'd like to bring the quickstarts/tutorials readme instructions into the Tutorials section of the docs? Instead of just linking off to them like we do now?
I do, but I would like to hear @paulyuk 's opinion too as quickstarts maintainer