[Grok-dev] Grok.traverser Code Documentation Feedback and proposal.

2 views

Skip to first unread message

unread,

Aug 12, 2014, 1:15:50 PM8/12/14

to grok...@zope.org

I put up three web pages about grokcore.traverser.

Here is my page documenting the source code.

Here are my comments about the source code from a Human Factors point of view.

And here is my proposal as to what should be done to improve the code.

Why am I writing this? Well I am just implementing parental acquisition for Zopache, and so I need

to modify the default traversal software.

I find that documenting software helps me to understand it better. Describing it, crystallizes my

concepts. And other people care, and so they read carefully, and correct any mistakes.

And finally these mailing lists are so quiet, I am sure that many people are happy that something

new, albeit controversial, is happening.

So I invite you to go ahead and read the documentation I wrote, and the comments.

But before you begin, let me say I am just amazed at the brilliance of the People who wrote Grok. I

could never have even imagined this framework, let alone written such high quality bug-free code.

Thank you enormously for those who did it.

And of course if anyone wants to talk to me about what I am doing for Parental Acquisition during