I've returned to programming and using PubSub again, and I realize I don't know if I've seen a standard way of documenting the messages sent by various functions and methods.
Has anyone addressed this?
Currently, in my docstring, I am creating simple text tables before explaining the output:
"""...
This function emits PubSub.Pub messages:
TOPIC ARGS
creating_debit start (bool)
creating_debit_information this (int) total=number_of_reports (int)
Returns the file name (either the first name-ID pair, or error.xls)
"""