Thanks to you all. You've given me a lot to think about.
After pondering, it does seem to me that there's no reason not to just put it in the documentation, with a sample dump and all if I must. POD or whatever, within the object doesn't seem as clever now as it did at first! lol.