This is good to describe, minimally, in the module docstring, however, the details on how to write one and what all the ramifications and such are can go in a high level document in the developer docs.