docs
docs copied to clipboard
Move the 10-minute-tutorial(s) to source code and enable running them in a pre-built environments
🤔 What's the problem you've observed?
Looking at the 10 Minute Tutorial, copying & pasting sample code seems like a very ineffective way of learning in the 21st century.
And neither can my colleagues who I'm trying to get into BDD can be bothered to follow this way of learning. There are much better ways to get a much smoother online learning experience.
How much effort would it take to add a new language (Golang) to the huge markdown doc? Probably a lot. The source file is so huge that I've given up before even starting.
✨ Do you have a proposal for making it better?
Yes. Use online IDE.
I've tried these and would never go back to copy & paste walkthroughs. Why can't we use something like that? Fear of locking-in?
- Github Codespaces (free tier)
- GitPod (free tier)
- Replit (free tier)
Running 10 Minute Tutorial should take 10 minutes working on BDD and no time settings things up. It's possible to define an environment for each language and let anyone log in into it (their own instance) with everything already set up, some basic files ready to be worked on, and possibly even a directory with the final solution for reference. Why not?
📚 Any additional context?
This text was originally generated from a template, then edited by hand. You can modify the template here.