dapr / docs

Dapr user documentation, used to build docs.dapr.io
https://docs.dapr.io
Creative Commons Attribution 4.0 International
987 stars 715 forks source link

Two types of tutorials, should be unified #4235

Open pdebruin opened 5 days ago

pdebruin commented 5 days ago

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