▲ 1517 ▼ Lemmy enjoys growth as developers pivot from Reddit amid API charging controversy (alternativeto.net) submitted 3 years ago by snoopa@lemmy.ml to c/lemmy@lemmy.ml 225 comments fedilink hide all child comments
[–] Cr4yfish@lemmy.world 41 points 3 years ago (12 children) I just wished the Lemmy API docs were better lol. permalink fedilink source hideshow 12 child comments replies: [–] drcobaltjedi@programming.dev 26 points 3 years ago (8 children) 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 permalink fedilink source parent hideshow 8 child comments replies: [–] danc4498@lemmy.world 8 points 3 years ago* (last edited 3 years ago) (1 child) More devs that don't want to write code? Edit: damn, meant to say write documentation. We only want to code! permalink fedilink source parent hideshow 1 child comment replies: [–] drcobaltjedi@programming.dev 4 points 3 years ago Well, more devs that have to sit down and figure out how the code works and then document it for future new devs permalink fedilink source parent [–] tomorrow_famous@feddit.uk 7 points 3 years ago I don't think that is contained to FOSS passion projects ;) permalink fedilink source parent [–] Acheron@sh.itjust.works 5 points 3 years ago 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 permalink fedilink source parent [+] Boinketh@lemm.ee 4 points 3 years ago* (last edited 3 years ago) [deleted] permalink fedilink source parent [–] c0c0c0@lemmy.world 3 points 3 years ago Maybe we'll eventually get the corresponding influx of tech writers. permalink fedilink source parent [–] tool@r.rosettast0ned.com 3 points 3 years ago I think that this line of reasoning becomes less and less tenable when things like Swagger exist. permalink fedilink source parent [–] astral_avocado@programming.dev 1 point 3 years ago It's like almost every piece of software, period. permalink fedilink source parent [–] tool@r.rosettast0ned.com 14 points 3 years ago I just wished the Lemmy API docs were better lol. 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. permalink fedilink source parent [–] Fauzruk@lemmy.world 10 points 3 years ago 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. permalink fedilink source parent [–] Dirk@lemmy.ml 9 points 3 years ago Fediverse software API documentation is bad across all fediverse software. permalink fedilink source parent
[–] drcobaltjedi@programming.dev 26 points 3 years ago (8 children) 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 permalink fedilink source parent hideshow 8 child comments replies: [–] danc4498@lemmy.world 8 points 3 years ago* (last edited 3 years ago) (1 child) More devs that don't want to write code? Edit: damn, meant to say write documentation. We only want to code! permalink fedilink source parent hideshow 1 child comment replies: [–] drcobaltjedi@programming.dev 4 points 3 years ago Well, more devs that have to sit down and figure out how the code works and then document it for future new devs permalink fedilink source parent [–] tomorrow_famous@feddit.uk 7 points 3 years ago I don't think that is contained to FOSS passion projects ;) permalink fedilink source parent [–] Acheron@sh.itjust.works 5 points 3 years ago 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 permalink fedilink source parent [+] Boinketh@lemm.ee 4 points 3 years ago* (last edited 3 years ago) [deleted] permalink fedilink source parent [–] c0c0c0@lemmy.world 3 points 3 years ago Maybe we'll eventually get the corresponding influx of tech writers. permalink fedilink source parent [–] tool@r.rosettast0ned.com 3 points 3 years ago I think that this line of reasoning becomes less and less tenable when things like Swagger exist. permalink fedilink source parent [–] astral_avocado@programming.dev 1 point 3 years ago It's like almost every piece of software, period. permalink fedilink source parent
[–] danc4498@lemmy.world 8 points 3 years ago* (last edited 3 years ago) (1 child) More devs that don't want to write code? Edit: damn, meant to say write documentation. We only want to code! permalink fedilink source parent hideshow 1 child comment replies: [–] drcobaltjedi@programming.dev 4 points 3 years ago Well, more devs that have to sit down and figure out how the code works and then document it for future new devs permalink fedilink source parent
[–] drcobaltjedi@programming.dev 4 points 3 years ago Well, more devs that have to sit down and figure out how the code works and then document it for future new devs permalink fedilink source parent
[–] tomorrow_famous@feddit.uk 7 points 3 years ago I don't think that is contained to FOSS passion projects ;) permalink fedilink source parent
[–] Acheron@sh.itjust.works 5 points 3 years ago 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 permalink fedilink source parent
[+] Boinketh@lemm.ee 4 points 3 years ago* (last edited 3 years ago) [deleted] permalink fedilink source parent
[–] c0c0c0@lemmy.world 3 points 3 years ago Maybe we'll eventually get the corresponding influx of tech writers. permalink fedilink source parent
[–] tool@r.rosettast0ned.com 3 points 3 years ago I think that this line of reasoning becomes less and less tenable when things like Swagger exist. permalink fedilink source parent
[–] astral_avocado@programming.dev 1 point 3 years ago It's like almost every piece of software, period. permalink fedilink source parent
[–] tool@r.rosettast0ned.com 14 points 3 years ago I just wished the Lemmy API docs were better lol. 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. permalink fedilink source parent
[–] Fauzruk@lemmy.world 10 points 3 years ago 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. permalink fedilink source parent
[–] Dirk@lemmy.ml 9 points 3 years ago Fediverse software API documentation is bad across all fediverse software. permalink fedilink source parent