[Grok-doc] On "Navigating To Transient Objects Tutorial"

[Sebastian Ware]

Hi Brandon!

I believe this is your article. Maybe you could give Paul some feedback.

https://blueprints.launchpad.net/grok/+spec/doc-navigating-to-transient-objects-tutorial
http://grok.zope.org/documentation/tutorial/navigating-to-transient-objects-tutorial

Mvh Sebastian


On 19 okt 2009, at 16.01, Paul Wilson wrote:

> Hi there,
>
> I've just reviewed the article "Navigating To Transient Objects" and
> have a number of comments. (It's a large one and it would be nice to
> get this one approved!). All the code examples work without any
> change!
>
> I'm going to reread the narrative and double check the grammar, but in
> the meantime I have a couple of comments/suggestions:
>
>  * The doctest titled "A Simple Implementation of Natural Numbers"
> uses what I believe is an older set up style. It uses:
>         def test_suite():
>                 return  
> unittest.TestSuite([ DocFileSuite('natural.txt') ])
>     but I think this could be replaced with a simple :doctest: marker
> considering we are now using the
> z3c.testsetup.register_all_tests('package.name') facility to discover
> tests.
>
> * The code example contained within the section "Providing Links To
> Other Objects" should import zope.location.
>
> * The "Providing Links To Other Objects" section ends with the
> statement "This should get easier in a future version of Grok and
> Zope!". Can anyone verify that the situation hasn't changed with
> regards to this functionality??
>
> Advice on these points would be very welcome indeed!
>
> Regards,
> Paul
> _______________________________________________
> grok-doc mailing list
> grok-doc at zope.org
> https://mail.zope.org/mailman/listinfo/grok-doc