Comments in the code are nice, but also very nice: a short introduction text, about the goal and how it's done, before the actual code. When you download a .tex file, you can see the (hidden) markup with description in a comment environment, also on TeXample.net
If you like, you can send me a first bunch of examples earlier, so I can implement and tell you if some change would improve the handling