4 ms·
I have a better answer well at least for me personally. Program tutorials are hard to understand because so many of them are written with no good hypertext. The
by navjack27 2y ago
I have a better answer well at least for me personally. Program tutorials are hard to understand because so many of them are written with no good hypertext. There is also an abundance of tutorials where you get single letter variables that seem to assume you have a math background and aren't completely paralyzed when looking at a formula.
The hypertext thing goes to what started me finally and so late with programming. I never used Matlab before and I was curious about it because I'm curious about lots of stuff. I pirated it a couple years ago and started using the live script or whatever the hell it's called. I really needed at the time an easy way to do an image quality metric comparison and this is all built in on MATLAB. I was really quickly able to build out a thing that was able to take two images and then compare them using all of the available quality metrics and also spit out a difference image. I was able to do this all inside of the IDE because all I had to do was highlight things I wrote and right click on them and there was beautiful UX for getting a definition in the help of what the thing meant how it's used and how it could be used with full syntax and clickable syntax for more context sensitive help. This is all stuff computers are good at but the humans writing the thing have to know why this is important and this is incredibly important. I never had to leave the environment to get clear and concise explanations. I didn't even need a tutorial. I just poked and prodded and read the help and eventually came out with this: https://github.com/navjack/imagequalitycompare_matlab https://github.com/navjack/imagequalitycompare_matlab
And you could see through my style that I adapted, if you know Matlab livescript, I really believe in verbose code and commenting. https://github.com/navjack/imagequalitycompare_matlab/blob/master/ImageQualityCompare_LiveScript_Manual/ImageQualityCompare_Manual.mlx.txt https://github.com/navjack/imagequalitycompare_matlab/blob/m...
I think anyone can read that code up there and know exactly what it does even if they don't know the coding language.
This success in programming got me excited so eventually I went on from there to Python and PowerShell and dabbling in c# and Go and Rust. I basically realized after that that I wasn't bad at programming that in reality lots of programming resources make a lot of assumptions. But these assumptions are different than the assumptions that a verbose help document make. So instead of seeking out resources I started seeking out just official documentation for things and development environments that gave me context sensitive autocomplete intellicode or even AI coding companions that were basically just autocomplete on steroids at the time.
But if you give me a tutorial or an explanation for a thing that uses single letter variables instead of formatting correct casing long name variables then I'm going to simply ignore your tutorial.