[Community Tutorials] some suggestions for improving tutorials and the process of creating

  1. Allow to include links to official docs or other tutorials. Currently links are not recognized in editor and are not clickable when viewing the published version.

  2. Allow to preview code snippet without having to open it in another window. It will be easier to spot issues and it is also handy if you have multiple snippets.

  3. Sometimes the whole tutorial cannot be saved if one of the snippet contains empty field. Either allow to save with snippets with placeholders/empty text or update the error to say what exactly is wrong on save.

It is a bit stressful experience all work can be lost because of one snippet.

  1. When adding Verse snippets I noticed I had to change type every time. It is unlikely code snippets would be in different coding languages in a single document. Maybe save my Verse preference after I added one Verse snippet and all following should be added as Verse snippets.

  2. Text must first be converted to huge heading and then can be converted to smaller h3/h4 as an additional step (which is not obvious you can do this without doing the huge heading first). It would be good to be able to directly set the level.

  3. I could not find the Verse tag and tag my tutorial or find similar tutorials.

  4. It would be cool to be able to expand all code snippets in the page or at least show more lines. For verse snippets all you see are imports ( Using bla bla) I think each should show 20 lines instead of 9.

Thanks!

@latunda Thank you for your feedback. While I cannot guarantee a response, I can confirm that this has been forwarded to the appropriate team.

1 Like