Re: [hibernate-dev] 2LC docs

+1. I think we need to generally understand a user guide and an integration guide. Very different audiences. On Mon, Jan 25, 2016 at 6:22 AM Vlad Mihalcea wrote: > Thanks. Well, the User Guide must detail the API and focus on general > usage. > We don't want to scare

Re: [hibernate-dev] 2LC docs

On 01/22/2016 05:26 PM, Steve Ebersole wrote: > On Fri, Jan 22, 2016 at 9:30 AM Radim Vansa > wrote: > > On 01/22/2016 03:11 PM, Steve Ebersole wrote: > > On Fri, Jan 22, 2016 at 7:21 AM Radim Vansa

Re: [hibernate-dev] 2LC docs

Hi, I have some sequence diagrams depicting the async/sync behavior if you are interested: For async: NONSTREICT_READ_WRITE and READ_WRITE: http://vladmihalcea.com/2015/05/18/how-does-hibernate-nonstrict_read_write-cacheconcurrencystrategy-work/

Re: [hibernate-dev] 2LC docs

On 01/25/2016 11:48 AM, Radim Vansa wrote: > On 01/22/2016 05:26 PM, Steve Ebersole wrote: >> On Fri, Jan 22, 2016 at 9:30 AM Radim Vansa > > wrote: >> >> On 01/22/2016 03:11 PM, Steve Ebersole wrote: >> > On Fri, Jan 22, 2016 at 7:21 AM Radim

Re: [hibernate-dev] 2LC docs

Thanks. Well, the User Guide must detail the API and focus on general usage. We don't want to scare users with internal details that are more useful in a Developer Guide or Integrator Guide. So we must find the right balance for what info we supply in the User Guide. Vlad On Mon, Jan 25, 2016

Re: [hibernate-dev] 2LC docs

I'd like to ask for some details on these (probably Steve): read-write:: If the application needs to update data, a read-write cache might be appropriate. This cache strategy should never be used if serializable transaction isolation level is required. If the cache is used in a JTA

Re: [hibernate-dev] 2LC docs

On Fri, Jan 22, 2016 at 7:21 AM Radim Vansa wrote: > Why should the strategy 'never be used if serializable transaction > isolation level is required'? What guarantees it gives, and what in ORM > core depends on this? When I've asked the last time, Steve said that all > modes

Re: [hibernate-dev] 2LC docs

On Fri, Jan 22, 2016 at 9:30 AM Radim Vansa wrote: > On 01/22/2016 03:11 PM, Steve Ebersole wrote: > > On Fri, Jan 22, 2016 at 7:21 AM Radim Vansa > > wrote: > > > > Why should the strategy 'never be used if serializable

Re: [hibernate-dev] 2LC docs

Seems much more comprehensive, though I can't find e.g. 'Cache-provider/concurrency-strategy compatibility' table (already out-of-date). Nevertheless, thanks! I'll try to find some timeslot for updating it early next week. Radim On 01/21/2016 04:17 PM, Vlad Mihalcea wrote: > Hi Radim, > >

Re: [hibernate-dev] 2LC docs

Hi Radim, I've just committed the updated version of the Caching chapter. To build it, you need to: 1. go to the documentation folder 2. run gradle rUG 3. The new user guide is located under: documentation/target/asciidoc/userguide/html/Hibernate_User_Guide.html Let me know what you think.

Re: [hibernate-dev] 2LC docs

I would say that the best source is 4.x docs, since the cited source is what I describe by 'close to nothing'. I understand that for 5.1 the transformation might be unfinished, but I was surprised by the same for 5.0 - missing information that's written, maybe just not formatted properly for

Re: [hibernate-dev] 2LC docs

Hi Radim, I'm now filling in the missing sections on the Caching chapter in the 5.1 User Guide. Vlad On Wed, Jan 20, 2016 at 11:32 AM, Radim Vansa wrote: > I would say that the best source is 4.x docs, since the cited source is > what I describe by 'close to nothing'. > > I

Re: [hibernate-dev] 2LC docs

The docs are in a state of flux for 5.1. For now your best bet is the source: documentation/src/main/asciidoc/userguide/chapters/caching/Caching.adoc On Fri, Jan 15, 2016 at 3:48 AM Radim Vansa wrote: > Hi, > > I was about to fill some gaps in 2LC docs regarding improvements

[hibernate-dev] 2LC docs

Hi, I was about to fill some gaps in 2LC docs regarding improvements in 5.0/5.1, but when I took a look into 5.0 docs [1] there's close to nothing; is it by purpose? In 4.3 docs [2], there's much more on this subject. Am I looking in a wrong place? Radim [1]