I'm currently developing some Standard Operation Procedures for the company I work for. I'm starting with the very small examples; like scripts. There are currently several scripts being written in different languages. The idea is to stick with the best practices of each language for when developing a tool. The real problem for the business is that how to use a script and what the script is used for is passed by word of mouth.
Therefore for each repository, I'll provide a SOP for:
Version Control best practices.
Starting with #4 I know that in Python a Script can be developed with help docstring embedded into the code. I was wondering then; what is the difference between this approach and the actual man pages?
Most of the developers here are working on Windows.
In terms of best practices both approaches should be required or just the embedded Python --help documentation?