++~~**//LINK TO THE TUTORIAL\\**~~++
I once wrote in a blog post
that I would make my ASM tutorial online one day, because it's really nice to just click around to go to pages. One year later, and here we are!
One thing that has always bothered me about my ASM tutorials is the fact that you have to download the entire tutorial and store it somewhere if you want to read it. The downside of that is that when I wanted to publish updates, I'd have to reupload the whole thing and then let the entire internet know that there's a new version. I'd have no idea if I would reach my audience, which is why I've been reluctant to update my tutorial to begin with. (plus I didn't want to reset the download counter and ratings although to be fair I don't actually remember if the system works that way)
Another thing that has always bothered me, is how my ASM tutorial really is just one giant book you have to manually scroll through. I can imagine that it's a bit of a hassle to read, especially for programmers who are rather used to clicking around, to go to the content they want to read about. I mean, we're hobbyists here. User experience wasn't really on my mind when I first wrote my ASM tutorial; I just wanted to dump everything I know into one large document. But I think people still deserve some usability.
This online version fixes both of these problems. By using Gitbook, the tutorial is now clickable and actually divided into chapters and sections, kind of like a Wiki of some sorts. The entire tutorial is also now versioned at Github
. Any updates I make to the main branch will automatically update the Gitbook I linked at the very beginning. People can also leave suggestions by using issues, or simply make a pull request to update a part of the Gitbook.
It's still work in progress, but it's progressing nicely. There are still some chapters and paragraphs I need to port over from the SMWC version, to this online version. However, I'd say it's finally about time I officially announce this. Technically speaking, it was never a secret as I've been working on this on my Github every now and then!
Sometimes, I search my name on various Discord servers and I see my ASM tutorial mentioned. It actually motivates me to maintain the tutorial and make it be of good quality. It gives me a good feeling about it and the readers (probably) will like it too. I hope that the community will like the renewed tutorial. Just bear in mind that as of the writing of this post, it's still work in progress.
Edit: I also forgot to mention that there's a bunch of new chapters as well, such as SNES hardware math as well as vectors. The tutorial sort of focuses on the SNES as a whole, rather than just the opcodes.
. I could post stuff now and then