Good start.

I'd also explain why fail-fast is important (don't want to abort a transaction just because caching - an optimisation - couldn't be done).

Also, these two sentences are a bit clunky: "This operation is particularly useful when Infinispan is used as cache to store data that's frequently read, which originates in another data store. The aim of this operation is to deal with concurrent storage of data, which originates in the data store, in the cache in the most efficient way."

How about: "This operation is particularly useful when Infinispan is used as a temporary cache for data that is persisted elsewhere.  Under heavy read scenarios, contention in the cache should not delay the real transactions at hand, since caching should just be an optimization and not something that gets in the way."

Cheers
Manik

On 16 Jan 2012, at 11:10, Galder Zamarreņo wrote:

Hi all,

The information on the putForExternalRead javadoc, although useful, was a bit limited, so I've extended it in a documentation section:
https://docs.jboss.org/author/x/RAY5

Please have a read and let me know what you think.

Cheers,
--
Galder Zamarreņo
Sr. Software Engineer
Infinispan, JBoss Cache


_______________________________________________
infinispan-dev mailing list
infinispan-dev@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/infinispan-dev

--
Manik Surtani
manik@jboss.org
twitter.com/maniksurtani

Lead, Infinispan
http://www.infinispan.org