One of the things that I like about sage is python, but what I like least 
about it is documentation, which is often missing or inadequate.

Because there is no documentation about the pickle_jar, and how it should 
be used, I wasted 4+ hours on this. First I was told to replace the broken 
pickles, which I did. When it was explained to me that this wasn't how the 
pickle_jar is supposed to work I found the documentation on 
register_unpickle_override 
to be about as useful as trying to explain matrix multiplication using 1x1 
matrices. A non-trivial example would help.

Sage needs documentation explaining what the pickle_jar is for, and what 
should be done when a pickle in the jar is broken. Having documentation 
would have saved me 3+ hours, some of Jeroen's time, plus all of the time 
people have spent on this thread. Old hands in sage know what the 
pickle_jar is for and how to use it but I don't see how newer people can 
learn this if it is not written down somewhere.

To end on a positive note, thanks again to Nils who gave me the hint that I 
needed to fix the problems with #9265 and #13072.

Andrew

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To post to this group, send email to sage-devel@googlegroups.com.
To unsubscribe from this group, send email to 
sage-devel+unsubscr...@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-devel?hl=en.


Reply via email to