[Dev] Objection to the new CPIA example

Katie Capps Parlante capps at osafoundation.org
Mon Nov 7 11:59:51 PST 2005


Alec Flett wrote:
> 1) Documentation: We should not introduce, let alone write sample code 
> that leads a user down a path that is different from where they will end 
> up. By introducing a new detail view mechanism, the reader will be 
> confused down the line when they try to understand how the first pattern 
> they learned fits together with a newer, incompatible pattern.
> 
> Personally I also object to the specific mechanism that john is using 
> here, and would have voiced my objection had I known what was being 
> proposed.

Alec, do you have objections to the mechanism beyond the issue of two 
different patterns? If so, can you elaborate?

Cheers,
Katie


More information about the Dev mailing list