<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Good start.<div><br></div><div>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).</div><div><br></div><div>Also, these two sentences are a bit clunky: "<span style="color: rgb(51, 51, 51); font-family: Arial, Helvetica, FreeSans, sans-serif; font-size: 13px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 17px; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); display: inline !important; float: none; ">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."</span></div><div><div style="text-align: left;"><font class="Apple-style-span" color="#333333" face="Arial, Helvetica, FreeSans, sans-serif"><span class="Apple-style-span" style="font-size: 13px; line-height: 17px;"><br></span></font></div><div style="text-align: left;"><font class="Apple-style-span" color="#333333" face="Arial, Helvetica, FreeSans, sans-serif"><span class="Apple-style-span" style="font-size: 13px; line-height: 17px;">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."</span></font></div><div style="text-align: left;"><font class="Apple-style-span" color="#333333" face="Arial, Helvetica, FreeSans, sans-serif"><span class="Apple-style-span" style="font-size: 13px; line-height: 17px;"><br></span></font></div><div style="text-align: left;"><font class="Apple-style-span" color="#333333" face="Arial, Helvetica, FreeSans, sans-serif"><span class="Apple-style-span" style="font-size: 13px; line-height: 17px;">Cheers</span></font></div><div style="text-align: left;"><font class="Apple-style-span" color="#333333" face="Arial, Helvetica, FreeSans, sans-serif"><span class="Apple-style-span" style="font-size: 13px; line-height: 17px;">Manik</span></font></div><div style="text-align: left;"><font class="Apple-style-span" color="#333333" face="Arial, Helvetica, FreeSans, sans-serif"><span class="Apple-style-span" style="font-size: 13px; line-height: 17px;"><br></span></font></div><div><div>On 16 Jan 2012, at 11:10, Galder Zamarreņo wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>Hi all,<br><br>The information on the putForExternalRead javadoc, although useful, was a bit limited, so I've extended it in a documentation section:<br><a href="https://docs.jboss.org/author/x/RAY5">https://docs.jboss.org/author/x/RAY5</a><br><br>Please have a read and let me know what you think.<br><br>Cheers,<br>--<br>Galder Zamarreņo<br>Sr. Software Engineer<br>Infinispan, JBoss Cache<br><br><br>_______________________________________________<br>infinispan-dev mailing list<br>infinispan-dev@lists.jboss.org<br>https://lists.jboss.org/mailman/listinfo/infinispan-dev<br></div></blockquote></div><br><div apple-content-edited="true">
<div><div>--</div><div>Manik Surtani</div><div><a href="mailto:manik@jboss.org">manik@jboss.org</a></div><div><a href="http://twitter.com/maniksurtani">twitter.com/maniksurtani</a></div><div><br></div><div>Lead, Infinispan</div><div><a href="http://www.infinispan.org">http://www.infinispan.org</a></div><div><br></div></div><br class="Apple-interchange-newline">
</div>
<br></div></body></html>