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
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
It’s a pretty major pain point for a lot of local libraries, too. I’m so glad I have the option to dig through the source code of functions if I can’t figure them out.
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.
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
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
Maybe we’ll eventually get the corresponding influx of tech writers.
It’s a pretty major pain point for a lot of local libraries, too. I’m so glad I have the option to dig through the source code of functions if I can’t figure them out.
I think that this line of reasoning becomes less and less tenable when things like Swagger exist.
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.