Mailing List Archive

Hi Alex,

Il 10/12/2012 15:16, Alex Clark ha scritto:
> Hi,
>
>
> I was studying the ZCA over the wkend and found the zope.interface
> docs a bit… dry. So I wrote "other":
>
>
> - https://github.com/aclark4life/other/blob/master/other.py
>
>
> The goals are:
>
> - Make Zope fun, not scary.
> - Teach people the ZCA.
> - Provide working code (pip install other)
>
>
>
> Comments/feedback welcome!
>
>
>
> Alex
>
>
>
>

- IMHO your guide *is* funny...provided that you already know the
concepts. If not, one would probably prefer a little bit more "theory"
before each joke in order to get them better. For ex. why an interface
is "implemented by" a class and "provided by" an object? what's the
difference?

- there's a bit of "noise": IAmbiguity, IGuess,.. (etc) are just marker
interfaces. I understand that those are parts of the joke, but I would
probably put them in a separate place.

my 2¢,
Great job, cheers,
Giacomo

--
Giacomo Spettoli

Twitter: http://twitter.com/giacomospettoli
LinkedIn: http://linkedin.com/in/giacomospettoli

_______________________________________________
Zope maillist - Zope@zope.org
https://mail.zope.org/mailman/listinfo/zope
** No cross posts or HTML encoding! **
(Related lists -
https://mail.zope.org/mailman/listinfo/zope-announce
https://mail.zope.org/mailman/listinfo/zope-dev )

On 2012-12-10 18:35:52 +0000, Giacomo Spettoli said:

> - IMHO your guide *is* funny...provided that you already know the
> concepts. If not, one would probably prefer a little bit more "theory"
> before each joke in order to get them better. For ex. why an interface
> is "implemented by" a class and "provided by" an object? what's the
> difference?
>
> - there's a bit of "noise": IAmbiguity, IGuess,.. (etc) are just marker
> interfaces. I understand that those are parts of the joke, but I would
> probably put them in a separate place.


Thanks for the feedback!
https://github.com/aclark4life/other/commit/f3587971f83b07a7d8ed3ef7733592b1c6594d4b
attempts to address both of your concerns. I agree I want to cover
theory, and as for "noise": I can group the interface definitions with
the print statements if that helps. I think it's important to see the
defs when you learning, rather than e.g. move them into interfaces.py.


--
Alex Clark · https://www.gittip.com/aclark4life/


_______________________________________________
Zope maillist - Zope@zope.org
https://mail.zope.org/mailman/listinfo/zope
** No cross posts or HTML encoding! **
(Related lists -
https://mail.zope.org/mailman/listinfo/zope-announce
https://mail.zope.org/mailman/listinfo/zope-dev )