Preface: I'm in the "open source authors don't owe you anything" camp, so the author of nREPL is under no obligation to provide documentation or even justify their decisions.
THAT BEING SAID, some of the arguments in this piece are odd:
"We added the other serializer options much later and almost nobody uses them so we must have made the right decision" - there's a huge amount of conceptual inertia when there's a default; the only thing this observation supports is that the default isn't _unpleasant enough_ to compel users to switch.
"It's not Clojure specific" is immediately followed by "so there are some protocol responses that people had to reverse-engineer that are tightly coupled to Clojure metadata".
"I'm gonna someday" is not "addressing" the complaint that things aren't documented, other than to make an excuse.
Preface: I'm in the "open source authors don't owe you anything" camp, so the author of nREPL is under no obligation to provide documentation or even justify their decisions.
THAT BEING SAID, some of the arguments in this piece are odd:
"We added the other serializer options much later and almost nobody uses them so we must have made the right decision" - there's a huge amount of conceptual inertia when there's a default; the only thing this observation supports is that the default isn't _unpleasant enough_ to compel users to switch.
"It's not Clojure specific" is immediately followed by "so there are some protocol responses that people had to reverse-engineer that are tightly coupled to Clojure metadata".
"I'm gonna someday" is not "addressing" the complaint that things aren't documented, other than to make an excuse.