I'm really proud to present my fully documented source code for Elite on the Commodore 64.
This is the original 1985 source, recently released by Ian Bell, with every single line of code explained.
It’s a thing of beauty. Enjoy!
@markmoxon Ideal comments, perfect ones, like all assembler source code should be commented.
@stman Thank you, that’s really good to hear!
@markmoxon It's the way I comment my assembler code too myself, and all my life I've been complaining about all those who don't write such kind of comments, with same quality, and regularity, when coding in assembler. It's absolutely essential, including for one as a coder, because it's a way to double check your own code when writing a comment, and I found a lot of bugs I did thanks to that.
@stman Absolutely! The only issue is if you change the code and forget to update the comments - I’ve made that mistake more than once! - but that isn’t a problem when analysing a game like Elite, as the code doesn’t change. Anyway, glad to hear from someone else who likes comments; I don’t really believe in self-documenting code…