Well, I never said a word against writing inline comments here and there and I do that myself on a daily basis. This is like a stick-it note to future self, and this is fine.
I am advocating the clear split, in our mentality as well, between the documentation and drop-in comments.
