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.chugu...@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 <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 > > > > > -- Best regards, Ivan Pavlukhin
