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 <ptupit...@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 <vololo...@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
> >
>

Reply via email to