I think it would be interesting to address in a chapter of the documentation good practices both in programming and in the design of persistent classes. It would be ideal to present some code examples. Some examples to illustrate my point: How to ...