Lemmy's API documentation currently appears to be the JS client implementation found here: https://join-lemmy.org/api/
This is very misleading, as these docs document the behavior of the JS client and do not provide a language neutral way to figure out what's going on.
Compare Lemmy's docs with something like the ActivityPub docs https://www.w3.org/TR/activitypub/
Going off ActivityPub, I could actually start to see how it all works and looks together. With Lemmy, I can reason about how the JS client works and do my best, but working with Lemmy you sometimes have to consume the Rust source as well.
So, this raises the barrier of entry for someone wanting to do Lemmy integrations to someone that needs to consume the above docs, plus be comfortable reading JS and Rust.
I saw some older posts from the lemmy devs saying: "Well, writing docs is hard, so it's easier if we generate the docs from our JS client."
They aren't wrong, writing documentation IS hard. If Lemmy is serious about attracting a larger ecosystem, I consider better API documentation to be on the hot path. I'm concerned that the devs are happy with the autogenerated docs above and won't put any effort into improving them. Even worse, the people generating these docs are already familiar with Lemmy, so they probably think the current docs are adequate.
I don't know a quick solution -- raise money to pay someone to write docs? No clue. But, if you want to attract developers to this ecosystem, the current API documentation is insufficient.
RANT AHEAD:
Quite a few times now, I've seen the complaint that "the news refuses to cover the story about the migrants' sinking ship and focuses on the billionaires instead".
This strikes me as totally unsurprising. 99% of all news sites are given by gathering clicks and eyeballs. The Titan story has it all:
vs the migrants' story
I'm sorry, but if I headed up a news room OF COURSE you will run the first story. It's simply more exciting. This is NOT an example of class war or a personal vendetta against the poor.
If you are one of those who think the migrants story should be more closely followed why don't YOU lead a discussion about it, volunteer your money and/or time to organizations that support migrants, etc.
It's also a really boring complaint to see, because nearly ALL of the major news outlets DID cover the story, but guess what, it is far less engaging, so it gets less attention overall.
Don't blame the news for what stories get big -- blame the public and their fascination with these stories. The news outlets are only putting out what their audience wants to see.
Feel free to start a site that talks only about migration issues, but I think you'll find it way harder to make money vs talking about clickbait.
@yarr
@lemmy.fmhy.ml