Previously, Google would document functions, classes and (if applicable) 
exceptions for services, such as URLFetch. This has been replaced with a 
single API reference link that leads to auto-generated-from-source 
documentation. The formatting of the latter is poor. And you don't get 
exceptions, unless you notice that clicking next gets you to exceptions, 
usually.

There are more problems. An example. When you try to figure out the return 
value of set_multi_async(), you get this: See 
_set_multi_async_with_policy(). Which isn't mentioned in the documentation. 
So you might as well skip this new documentation and read the source.

https://cloud.google.com/appengine/docs/python/refdocs/google.appengine.api.memcache

I think this is a regression. It probably means less work for Google, but 
more work for users.

-- 
You received this message because you are subscribed to the Google Groups 
"Google App Engine" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/google-appengine.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/google-appengine/46a27738-911e-46e5-bfa3-bf4afbb5a084%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to