You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Hello,
I've been trying to use msgpack-java for a project of mine, and I keep having to look at the source code and trace through methods to try and understand how things work together. The main problem is that almost nothing outside of the main MessagePack class is documented.
Let's take a concrete example : I wanted to implement my own serializer for a certain type. I figured I would need to subclass Template after a while. However, I quickly hit this problem :
What does the parametrized argument in read method of Template actually do ?
It took me a while to figure out it was to use with Unpacker.read(T to) . Had it been documented as such with javadoc, I wouldn't have had to fiddle for so long.
Another question : what is the difference between the annotations Message and MessagePackMessage ? What do the annotations Beans, Delegate, OrdinalEnum and their respective MessagePack* do ?
I hope those questions can be answered, and hopefully their docs will be integrated into the javadoc.
Thank you for your comment, @roblabla. I'll blog the internal of msgpack-java in a few days to make it easier to understand msgpack-java. After reviewing from commiters of the blog, we should document it on javadoc and msgpack-wiki as you mentioned. Your contributing of docs by pull req is also welcome, of course :-)
Another question : what is the difference between the annotations Message and MessagePackMessage ? What do the annotations Beans, Delegate, OrdinalEnum and their respective MessagePack* do ?
@muga, can you describe this? I've not read annotation-related code, so I need your help.
i'd like to voice my support for this issue. It's nice that msgpack has gotten a site overhaul, but that arguably left the documentation for Java (and Scala) in a worse state it was before. I'm glad the msgpack devs recognize the need for an update of the Javadocs and the Wiki .
@MikKoz, thanks for your feedback. I'll share the state of lacks of documantation with developers at the hackathon. I'll also update Wiki/Javadocs at that time. If you have any idea about the information we should summarize about msgpack, let me know.
I don't mind at all, and it barely is a hijack considering the fact it is 100% on topic :)
And that seems like an accurate list of what needs to be documented.
@MikKoz, @roblabla,
Thanks for your great feedback :-) I've split this issue based on your comments. I'll do this step by step, incrementally. If you can help us, it's very wonderful.
Thanks for the project, but I am looking for more documentation for handling beans with message pack. I would like to have a bean converted into a map based on parameter name rather than position of the field in the java file (very brittle);
Activity
oza commentedon Aug 15, 2013
Thank you for your comment, @roblabla. I'll blog the internal of msgpack-java in a few days to make it easier to understand msgpack-java. After reviewing from commiters of the blog, we should document it on javadoc and msgpack-wiki as you mentioned. Your contributing of docs by pull req is also welcome, of course :-)
@muga, can you describe this? I've not read annotation-related code, so I need your help.
mikolak-net commentedon Aug 15, 2013
i'd like to voice my support for this issue. It's nice that msgpack has gotten a site overhaul, but that arguably left the documentation for Java (and Scala) in a worse state it was before. I'm glad the msgpack devs recognize the need for an update of the Javadocs and the Wiki .
oza commentedon Aug 16, 2013
@MikKoz, thanks for your feedback. I'll share the state of lacks of documantation with developers at the hackathon. I'll also update Wiki/Javadocs at that time. If you have any idea about the information we should summarize about msgpack, let me know.
mikolak-net commentedon Aug 16, 2013
@oza : Heh, I'd hate to hijack @roblabla 's issue, so I hope he agrees with what I'm about to write ;).
In my opinion, this should be included:
Have fun on the hackathon!
roblabla commentedon Aug 16, 2013
I don't mind at all, and it barely is a hijack considering the fact it is 100% on topic :)
And that seems like an accurate list of what needs to be documented.
mikkoz notifications@github.com wrote:
Sent from my Android phone with K-9 Mail. Please excuse my brevity.
oza commentedon Aug 28, 2013
@MikKoz, @roblabla,
Thanks for your great feedback :-) I've split this issue based on your comments. I'll do this step by step, incrementally. If you can help us, it's very wonderful.
mikolak-net commentedon Aug 28, 2013
@oza : I've noticed, great to see that :). If you need any further feedback, please let me know.
oza commentedon Aug 28, 2013
@MikKoz OK, I'll notify you when I finish writing docs. Thank you :)
chrislovecnm commentedon Jul 30, 2014
Thanks for the project, but I am looking for more documentation for handling beans with message pack. I would like to have a bean converted into a map based on parameter name rather than position of the field in the java file (very brittle);
Thanks in advance!