• Is it a programmer who needs to learn how to use the module and call it from their own programs?
• Or is it a programmer (you / your team mates) who needs to know how it works so they can work with and extend the code?

These two audiences have two quite different needs.

/J