ignite-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ivan Pavlukhin <vololo...@gmail.com>
Subject Re: Binary object format KB article
Date Wed, 16 Oct 2019 16:18:56 GMT
Sergey,

Thank you for a review!

> It seems to me that document tries to focus on details of the format itself but other
aspects of this functionality leak into the explanation and confuses reader.

You are absolutely right, it was an original idea. I will try to
define a terminology and clarify things about schemas.

ср, 16 окт. 2019 г. в 16:49, Sergey Chugunov <sergey.chugunov@gmail.com>:
>
> Then I would suggest to define good terminology at the very beginning of
> the article.
>
> Right in introduction section I see a lot of terms like "Binary object
> format", "Binary object container format" (is it the same thing?), "Binary
> serialization format". In the next section "binary type" pops up. What are
> the relations between them?
>
> Schemes part needs more examples. What is scheme? How it is related to
> binary type? Is it a one-to-one relationship? One-to-many? When a new
> scheme is created? Why type and scheme should be registered on a receiver
> side? And if the receiver exists then who is the sender?
>
> It seems to me that document tries to focus on details of the format itself
> but other aspects of this functionality leak into the explanation and
> confuses reader.
>
> On Wed, Oct 16, 2019 at 2:52 PM Ivan Pavlukhin <vololo100@gmail.com> wrote:
>
> > Pavel, Sergey,
> >
> > Thank you for your feedback!
> >
> > To be exact the document does not describe broad picture (including
> > metadata exchange) and is not a formal format specification
> > intentionally. I wanted to create a lightweight article giving an
> > intuition about binary object structure to a reader. And yes,
> > intuition about metadata registration is definitely an important,
> > related but slightly different subject.
> >
> > ср, 16 окт. 2019 г. в 14:23, Sergey Chugunov <sergey.chugunov@gmail.com>:
> > >
> > > Ivan, thank you for documenting this functionality, agree with Pavel
> > here.
> > >
> > > I think this document is a good starting point and contains a lot of
> > > low-level details and great examples but from my perspective it doesn't
> > > show how binary objects fit into a broader picture.
> > >
> > > It worth adding higher-level details and restructure the document into a
> > > top-down article starting from where binary format is used
> > (representation
> > > of objects in cache, binary protocol for communications with thin
> > clients)
> > > and down to lower details like binary metadata exchange and serialization
> > > and container formats.
> > >
> > > Another option would be to leave the document focused on a low-level
> > > details as it is now but build around it drafts for documents describing
> > > other aspects of Binary Objects.
> > > This will make our documentation much more solid and useful for readers.
> > >
> > > On Wed, Oct 16, 2019 at 2:07 PM Pavel Tupitsyn <ptupitsyn@apache.org>
> > wrote:
> > >
> > > > Ivan, great job, thanks for putting this together.
> > > >
> > > > I think we also need a more formal description of the format, including
> > > > binary metadata exchange mechanics.
> > > > It was done (partially) for IEP-9 Thin Client Protocol, we should
> > probably
> > > > copy from there:
> > > >
> > > >
> > https://cwiki.apache.org/confluence/display/IGNITE/IEP-9+Thin+Client+Protocol#IEP-9ThinClientProtocol-BinaryObjects
> > > >
> > > >
> > > >
> > > > On Wed, Oct 16, 2019 at 11:49 AM Ivan Pavlukhin <vololo100@gmail.com>
> > > > wrote:
> > > >
> > > > > Igniters,
> > > > >
> > > > > I published a document about Binary format in cwiki [1]. Please share
> > > > > your feedback. I feel that there is a lack of pictures on the page.
> > > > > Need to figure out what aspects will be more clear with pictures.
> > > > >
> > > > > [1]
> > > > >
> > https://cwiki.apache.org/confluence/display/IGNITE/Binary+object+format
> > > > >
> > > > > --
> > > > > Best regards,
> > > > > Ivan Pavlukhin
> > > > >
> > > >
> >
> >
> >
> > --
> > Best regards,
> > Ivan Pavlukhin
> >



-- 
Best regards,
Ivan Pavlukhin

Mime
View raw message