Share your repls and programming experiences

← Back to all posts
[PSA] Please Specify the Specifics
h
frissyn (447)

The Problem

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

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.

Disclaimer

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
Comments
hotnewtop
HahaYes (1900)

ah yes... this is cool, I'll keep this in mind

AstOwOlfo (249)

ahhhh repl tutorials... finally someone is calling them out. there’s far bigger problems with them than this but a good start

frissyn (447)

lol, wdym by "far bigger problems"?

AstOwOlfo (249)

I’ll be blunt, there’s a lot of useless cycle grabs and they’re generally not that helpful for the most part. @IreTheKID

frissyn (447)

Can't say that I disagree, but that's an entirely different issue tbh.

AstOwOlfo (249)

Ehh it’s all to do with quality is it not? I’d say it’s related @IreTheKID

AstOwOlfo (249)

Well, let’s hope things get better ;P @IreTheKID

AmazingMech2418 (1014)

With my OS tutorial, you can do it in a normal Linux environment too... You'd just have to replace install-pkg with apt install or whatever based on your distro.

AmazingMech2418 (1014)

@IreTheKID I feel like that's kind of common sense though... You can't do it on Windows or MacOS though without a VM.

frissyn (447)

I understand that, I just used your tutorial as an example to make a point, not everyone knows that though. Your tutorial was good!

AmazingMech2418 (1014)

@IreTheKID Thank you! I just thought that people would understand that installing packages with install-pkg can be done with other package managers too.