Do you have concerns about keeping your documentation in sync with your source? I find that when I'm working with examples that if they don't work I first assume that it is me or something in my configuration. The last thing I think of is that the docs are out of sync with the example.