develooper Front page | perl.qa | Postings from November 2011

Re: Document the delegator or the delegated?

Thread Previous | Thread Next
From:
Aristotle Pagaltzis
Date:
November 5, 2011 12:37
Subject:
Re: Document the delegator or the delegated?
Message ID:
20111105193730.GC24689@klangraum.plasmasturm.org
* Michael G Schwern <schwern@pobox.com> [2011-11-04 04:45]:
> When doing delegation I have a documentation dilemma: do the API docs
> go in the delegator or the delegate?

This is the classic reference vs tutorial dilemma, isn’t it?

The direct conclusion is that you want to have separate documentation
for the two different kinds of reading, which on CPAN generally takes
the form of ::Manual PODs.

Regards,
-- 
Aristotle Pagaltzis // <http://plasmasturm.org/>

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About