Either in the feature description or in the existing gotchas page should exist a description of the product limitations and other details related to this feature.
* all keys of a Map are always fully loaded
* collections of literals are always fully loaded
* others
Igal Levy added a comment - 16/Jan/09 06:35 PM The Clustered Data Structures Guide addresses these issues. Added a link from the "Virtual Heap" section of the Concept and Architecture Guide.