I've added a new docs category - Glossary. This is for defining terminology we use that new users (and experienced users) might have trouble with. "Data Grid" would be a great example. For each item in the glossary, create a page underneath Glossary, and then we can link it in using an include. An item in the Glossary should use an h2. heading and include the heading in the text body as well as have a page title - this just makes the item reusable. _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

* Data Grid * In-memory data grid * Write through * Write behind * MVCC * Optimistic Locking * Pessimistic Locking * Deadlock * Livelock * Write skew * Isolation level * 2-phase commit * 1-phase commit * XA resource * JTA synchronization * Split brain/network partition

I agree we should explain the ones which are specific for Infinispan, but many of those terms already have good definitions elsewhere. Instead of trying explaining them we could point to Wikipedia? Is there a way to incorporate a Wikipedia paragraph directly in confluence?

On 8 Jul 2011, at 13:27, Manik Surtani wrote: > -- Manik Surtani manik(a)jboss.org twitter.com/maniksurtani Lead, Infinispan http://www.infinispan.org _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

Ok the bits under my name are done. Anyone care to proof read and comment? :) ----- Original Message ----- From: Pete Muir <pmuir(a)redhat.com&gt; To: infinispan -Dev List <infinispan-dev(a)lists.jboss.org&gt; Sent: Fri, 08 Jul 2011 10:54:40 -0400 (EDT) Subject: Re: [infinispan-dev] New documentation type - Glossary There are stub's for all of these on the wiki now. I'm giving each of the core team responsibility for making a subset of the entries happen - that's not to say that this person must write the entry, just that they must make sure it get's written. Again, anyone who wants to help out and doesn't have write access to the docs, log in to confluence at least once and then send me your jboss.org username and I will give you access. Manik * Data Grid * In-memory data grid * BASE * CAP Theorem Vladimir * Split brain/network partition Mircea * 2-phase commit * 1-phase commit * XA resource * JTA synchronization Sanne * Isolation level * MVCC * Optimistic Locking * Pessimistic Locking Galder * Memcached * REST * Write through * Write behind Pete * ACID * NoSQL * SQL * RDBMS Dan * DHT * Consistent Hash * Deadlock * Livelock * Write skew On 8 Jul 2011, at 13:48, Manik Surtani wrote: > > On 8 Jul 2011, at 13:27, Manik Surtani wrote: > >> > > -- > Manik Surtani > manik(a)jboss.org > twitter.com/maniksurtani > > Lead, Infinispan > http://www.infinispan.org > > > > _______________________________________________ > infinispan-dev mailing list > infinispan-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/infinispan-dev _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

I've just written: https://docs.jboss.org/author/display/ISPN/Hot+Rod https://docs.jboss.org/author/display/ISPN/READ+COMMITTED https://docs.jboss.org/author/display/ISPN/REPEATABLE+READ https://docs.jboss.org/author/display/ISPN/Externalizer https://docs.jboss.org/author/display/ISPN/Memcached https://docs.jboss.org/author/display/ISPN/Representational+State+Transfe... https://docs.jboss.org/author/display/ISPN/Write+through https://docs.jboss.org/author/display/ISPN/Write+behind Cheers, On Jul 22, 2011, at 10:20 AM, Galder Zamarreño wrote: > Just had a read and looks good to me. > > On Jul 21, 2011, at 6:27 PM, Manik Surtani wrote: > >> Ok the bits under my name are done. Anyone care to proof read and comment? :) >> >> ----- Original Message ----- >> From: Pete Muir <pmuir(a)redhat.com&gt; >> To: infinispan -Dev List <infinispan-dev(a)lists.jboss.org&gt; >> Sent: Fri, 08 Jul 2011 10:54:40 -0400 (EDT) >> Subject: Re: [infinispan-dev] New documentation type - Glossary >> There are stub's for all of these on the wiki now. >> I'm giving each of the core team responsibility for making a subset of the entries happen - that's not to say that this person must write the entry, just that they must make sure it get's written. >> Again, anyone who wants to help out and doesn't have write access to the docs, log in to confluence at least once and then send me your jboss.org username and I will give you access. >> Manik >> * Data Grid >> * In-memory data grid >> * BASE >> * CAP Theorem >> Vladimir >> * Split brain/network partition >> Mircea >> * 2-phase commit >> * 1-phase commit >> * XA resource >> * JTA synchronization >> Sanne >> * Isolation level >> * MVCC >> * Optimistic Locking >> * Pessimistic Locking >> Galder >> * Memcached >> * REST >> * Write through >> * Write behind >> Pete >> * ACID >> * NoSQL >> * SQL >> * RDBMS >> Dan >> * DHT >> * Consistent Hash >> * Deadlock >> * Livelock >> * Write skew >> On 8 Jul 2011, at 13:48, Manik Surtani wrote: >>> >>> On 8 Jul 2011, at 13:27, Manik Surtani wrote: >>> >>>> >>> >>> -- >>> Manik Surtani >>> manik(a)jboss.org >>> twitter.com/maniksurtani >>> >>> Lead, Infinispan >>> http://www.infinispan.org >>> >>> >>> >>> _______________________________________________ >>> infinispan-dev mailing list >>> infinispan-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/infinispan-dev >> _______________________________________________ >> infinispan-dev mailing list >> infinispan-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/infinispan-dev >> _______________________________________________ >> infinispan-dev mailing list >> infinispan-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/infinispan-dev > > -- > Galder Zamarreño > Sr. Software Engineer > Infinispan, JBoss Cache > > > _______________________________________________ > infinispan-dev mailing list > infinispan-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/infinispan-dev -- Galder Zamarreño Sr. Software Engineer Infinispan, JBoss Cache _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

Are you happy with these changes? If you are, then I suggest people use the BASE entry (https://docs.jboss.org/author/display/ISPN/Basically+Available%2C+Soft-st...) as guide for how to write these entries...

Guidelines written up - https://docs.jboss.org/author/display/ISPN/Contributing+to+Infinispan#Con... On 24 Jul 2011, at 16:22, Manik Surtani wrote: > > On 22 Jul 2011, at 15:09, Pete Muir wrote: > >> Are you happy with these changes? If you are, then I suggest people use the BASE entry (https://docs.jboss.org/author/display/ISPN/Basically+Available%2C+Soft-st...) as guide for how to write these entries... > > This looks good. +1 to using this as a template for style, so that we have consistency. > -- > Manik Surtani > manik(a)jboss.org > twitter.com/maniksurtani > > Lead, Infinispan > http://www.infinispan.org > > > > _______________________________________________ > infinispan-dev mailing list > infinispan-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/infinispan-dev _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

Guidelines written up - https://docs.jboss.org/author/display/ISPN/Contributing+to+Infinispan#Con... On 24 Jul 2011, at 16:22, Manik Surtani wrote: > > On 22 Jul 2011, at 15:09, Pete Muir wrote: > >> Are you happy with these changes? If you are, then I suggest people use the BASE entry (https://docs.jboss.org/author/display/ISPN/Basically+Available%2C+Soft-st...) as guide for how to write these entries... > > This looks good. +1 to using this as a template for style, so that we have consistency. > -- > Manik Surtani > manik(a)jboss.org > twitter.com/maniksurtani > > Lead, Infinispan > http://www.infinispan.org > > > > _______________________________________________ > infinispan-dev mailing list > infinispan-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/infinispan-dev _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

On 8 Jul 2011, at 13:27, Manik Surtani wrote: > Do we want to come up with a list of terms that definitely need defining, at least from where we stand now? More will be added incrementally, for sure. > > * Data Grid http://www.jroller.com/cpurdy/entry/defining_a_data_grid It doesn't sound like a definition to me, but it is the only one I could find... > * In-memory data grid > * Write through > * Write behind - read ahead - cache aside - near cache > * MVCC > * Optimistic Locking > * Pessimistic Locking > * Deadlock > * Livelock > * Write skew > * Isolation level > * 2-phase commit > * 1-phase commit > * XA resource > * JTA synchronization > * Split brain/network partition > > ... what else? > > > > On 7 Jul 2011, at 17:14, Pete Muir wrote: > >> I've added a new docs category - Glossary. This is for defining terminology we use that new users (and experienced users) might have trouble with. "Data Grid" would be a great example. >> >> For each item in the glossary, create a page underneath Glossary, and then we can link it in using an include. An item in the Glossary should use an h2. heading and include the heading in the text body as well as have a page title - this just makes the item reusable. >> _______________________________________________ >> infinispan-dev mailing list >> infinispan-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/infinispan-dev > > -- > Manik Surtani > manik(a)jboss.org > twitter.com/maniksurtani > > Lead, Infinispan > http://www.infinispan.org > > > > > _______________________________________________ > infinispan-dev mailing list > infinispan-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/infinispan-dev _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev

On Jul 8, 2011, at 2:27 PM, Manik Surtani wrote: > Do we want to come up with a list of terms that definitely need defining, at least from where we stand now? More will be added incrementally, for sure. > > * Data Grid > * In-memory data grid > * Write through > * Write behind > * MVCC > * Optimistic Locking > * Pessimistic Locking > * Deadlock > * Livelock > * Write skew > * Isolation level > * 2-phase commit > * 1-phase commit > * XA resource > * JTA synchronization > * Split brain/network partition > > ... what else? Some that come to my mind: * HotRod * Read Committed * Repeteable Read * Externalizer > > > > On 7 Jul 2011, at 17:14, Pete Muir wrote: > >> I've added a new docs category - Glossary. This is for defining terminology we use that new users (and experienced users) might have trouble with. "Data Grid" would be a great example. >> >> For each item in the glossary, create a page underneath Glossary, and then we can link it in using an include. An item in the Glossary should use an h2. heading and include the heading in the text body as well as have a page title - this just makes the item reusable. >> _______________________________________________ >> infinispan-dev mailing list >> infinispan-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/infinispan-dev > > -- > Manik Surtani > manik(a)jboss.org > twitter.com/maniksurtani > > Lead, Infinispan > http://www.infinispan.org > > > > > _______________________________________________ > infinispan-dev mailing list > infinispan-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/infinispan-dev -- Galder Zamarreño Sr. Software Engineer Infinispan, JBoss Cache _______________________________________________ infinispan-dev mailing list infinispan-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/infinispan-dev