Well, sure, multi-line comments are a thing. Personally I feel if you're gonna write an explanatory essay like this, though, it should be in a separate file, but probably referenced in the implementation (or you could put it on the internet, I guess).
Out of curiosity, what parts did you feel were unclear?