I agree that code samples would be helpful. Even though (or
perhaps especially since) I'm still a fairly novice programmer, I
have always found actual working examples very helpful when
illustrating any technical point. I find examples also make the
narrative more enjoyable and interesting to read.