Procedural Tutorials are Superior

hassan shaikley
1 min readDec 12, 2023

--

Lately I’ve been trying to level up my knowledge by following various tutorials.

One thing that has consistently pained me has been…Object Orientation.

This is especially painful in JavaScript land where there are very many different patterns and I find myself spending time trying to understand the patterns and jumping around files, trying to keep track of what is going on.

Procedural programming would have made learning the concepts a lot easier.

There is a lot of value in suggesting patterns and code organization. But I can worry about that later and consumer resources focused on that.

A sequence of steps without OO is so much easier to follow.

I find myself rewriting the tutorials in a procedural way just to understand the sequence of steps.

This is a giant time waste and a pain. And it makes learning slower.

And, for the record, FP is better than OO for learning but procedural takes the cake because of colocality.

Please write your tutorials in a procedural manner, that is, in a sequence of copyable steps.

This allows the person learning to focus on the series of steps it takes to get somewhere in their most fundamental and clear way.

It also makes copying the code trivial.

And copying and manipulating code is, in large part, how I learn.

--

--

hassan shaikley
hassan shaikley

No responses yet