in reply to Nomenclature: names for roles

The person who reads your pod is the first kind of user. So just do your normal module documentation for him/her.

The second kind of user will read the documentation written by the first user. So you can add a "How to document your module" section in your pod. There you can tell your user what to say to his users.