Your skill will accomplish what the force of many cannot |
|
PerlMonks |
comment on |
( [id://3333]=superdoc: print w/replies, xml ) | Need Help?? |
All methods must be documented, even if it's simply a
how else would know what your API consists of? (it shouldn't be magic). Comments are not documentation -- or comments are documentation for the developers of the API. The users of the API should refer to the user documentation (the pod). Comments needn't truly be comments (=for comment ...=begin comment ...) I heartily disagree Abigail's comment that people who document every sub are wrong. There is no such thing as too much documentation, no matter how redundant it may be. Lack of documentation is almost always wrong (programmers should not resort to sourcediving to learn function names).
In reply to Re: Documenting Methods/Subs
by PodMaster
|
|