It is surprising how quickly we forget how to use scripts we had written, let alone, what they were for. So it is even more difficult for others to know how and whether to use your script. You can avoid wasting the efforts you put into the problems you solved with your script by simply adding some friendly “help” output.
Here is some basic information you should include:
- Summary description
- Form of use—basic syntactic usage
- Description of usage syntax; i.e., input parameters
- More detailed information, if necessary. Read the rest of this entry »