Am I missing something or is there literally zero API documentation for whatsoever?

· · Web · 1 · 1 · 1

I find it an odd choice to 'launch' what's supposedly meant to be an application-agnostic universal network, without any actual documented way to use it besides bindings to one specific application/UI framework

@joepie91 Reading the code (particularly the python bindings and the python dht chat demo) I think it's not hard to figure out. But yeah I agree that it does need documentation if they hope to attract devs. If I understood correctly, there's probably already people doing documentation in their discord. I haven't joined because I'm kind of avoiding discord. I wish they set up a matrix bridge.

@starsider I honestly don't think that "infer the correct usage from the code" is good enough for something that is supposed to be high-security; moreso when the Python client demo code uses unauthenticated(!) encryption.

("The code is the documentation" is generally problematic, it's just much worse when it's also security-sensitive stuff like cryptography)

@joepie91 I agree, but as I understand it's only "released" in the sense that it's for people that want to collaborate on the project itself, not to just make apps with it, yet. The very first thing the docs section says is that documentation is a work in progress and that people can join to help.

@starsider That seems to be the case, but this was definitely not clearly communicated in the whole promotional exercise around it being 'launched' and 'released', with all the hype that came with that.

Sign in to participate in the conversation
Pixietown

Small server part of the pixie.town infrastructure. Registration is closed.