I think this is a good idea. Most users will want many examples of how to use your module, and the SYNOPSIS is usually too terse (or worse, outdated). The test suite can then be seen as alternative documentation.