1498
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 12 Jul 2023
1498 points (99.4% liked)
Lemmy
12443 readers
81 users here now
Everything about Lemmy; bugs, gripes, praises, and advocacy.
For discussion about the lemmy.ml instance, go to !meta@lemmy.ml.
founded 4 years ago
MODERATORS
I just wished the Lemmy API docs were better lol.
Yeah, that's a problem with a lot of FOSS passion projects. We devs kinda like writting code, but not really documenting it. Hopefully with the influx of devs helping that will improve
More devs that don't want to write code?
Edit: damn, meant to say write documentation. We only want to code!
Well, more devs that have to sit down and figure out how the code works and then document it for future new devs
I don't think that is contained to FOSS passion projects ;)
I don’t really like all the LLM hype, but I’m hoping that documentation will eventually be generated by some open source model, with human verification
I think that this line of reasoning becomes less and less tenable when things like Swagger exist.
Maybe we'll eventually get the corresponding influx of tech writers.
It's like almost every piece of software, period.
Finnegans Wake makes more sense than Lemmy API docs. Even calling it "documentation" is a stretch.
I literally had to clone the Lemmy git repo and read the source code to find the implementation of an API endpoint and see how it worked for a script that I was writing.
These days the standard is to create an API Doc out of a OpenAPI document generated from the code itself. Someone will probably contribute to it at some point.
Fediverse software API documentation is bad across all fediverse software.