Re: [Zope] New ZCA tutorial underway

2012-12-10 Thread Giacomo Spettoli

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 )


Re: [Zope] New ZCA tutorial underway

2012-12-10 Thread Alex Clark

On 2012-12-10 18:35:52 +, 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 )