[PSA] Please Specify the Specifics
Now, I've been on repl.it for about 2 years now and been active on ReplTalk for the past 5 or so months. One "problem" (for lack of a better word) I encounter a lot, especially in tutorials is that people don't specify if what they are teaching applies only to repl.it as a web-based IDE and Compiler, or a general application (i.e something that could work in VSC, Atom, Sublime, etc.) This might not seem like a big issue, but as someone who first came to repl.it to utilize it's hosting features (i.e Flask Applications) and primarily works in MS Visual Studio Code it can be frustrating to follow a tutorial on ReplTalk in VSC, only to realize it'll only work on repl.it, or vice versa.
What's The Big Deal?
When I mentioned this to a friend of mine he said:
"It's not that big a deal dummy, get off of repl.it if u don't wanna use repl.it specific tutorials :/"
While this is a very good point, after all, why should I be complaining about repl.it specific tutorials on a forum that exists only on repl.it? This way of thinking though simply does not apply to a lot of the broader tutorials. Case in point: @AmazingMech2418 's How to Make a Basic OS tutorial. With a topic as broad as OS development it would only make sense to try out what they've learned here outside of the repl.it coding environment? After all, it could be said that repl.it is not primarily an OS development focused IDE/Compiler with plenty of limitations that won't exist when natively run on a physical machine. There are also plenty of tutorials that exist on repl.it that teach concepts that you couldn't execute on repl.it!
The solution to this problem is really basic and has two distinct paths in my view:
- Specify that what you are teaching only applies to repl.it
- Include a section that specifies what needs to be done to follow this tutorial elsewhere
Of course, one could not possibly provide details on every possible execution of the tutorial, and I sure wouldn't expect that, nor would I call for an explicit statement on every tutorial saying "The following only applies to repl.it", but when discussing broader topics, please take the time to address everyone, not just the sole repl.it users.
I don't want people to think that I'm posting out of vanity (I don't expect fellow users of the internet to listen to me just because I said so) I just recognized a problem that I had and brought it to the attention of the community. (I also don't mean to call you out @AmazingMech2418 , I liked your OS tutorial!)
Have a good day! =D
ahhhh repl tutorials... finally someone is calling them out. there’s far bigger problems with them than this but a good start
With my OS tutorial, you can do it in a normal Linux environment too... You'd just have to replace
apt install or whatever based on your distro.