Your experience mirrors mine, where you must refer to the Rust and/or JS code to have a chance in hell.

Yep… and if you and I got discouraged, how many other developers did as well? This is why good docs are essential for a healthy ecosystem.

No, I was just chewing on various ideas to integrate with Lemmy and was disappointed with the docs I saw. They seemed OK-ish if you wanted to use the JS client, but not great if you want to do something else.

On similar projects, I’m used to seeing OpenAPI/Swagger/etc. where you have docs on the incoming bodies/fields, what values they can contain, etc.

Right now it’s really bare bones. I see things like ‘auth’ OPTIONAL but not really sure what would go in there.

I can RTFS like another poster said, but of course that’s not as convenient as “general purpose” API docs with examples / tutorial.

I was curious to see if the reply was going to be:

• We are happy with the state of docs (WONTFIX)

OR

• The current situation is temporary and we will provide better docs at some point in the future

proper nouns like sed, awk and grep?

Totally, but at least Oracle doesn’t pretend they are some kind of beacon of open source. Red Hat is trying to party like it’s 1999 while it’s just a boring division of IBM now.

Why WOULDN’T we move off if something better came along?

I am. It’s there in the GPL text in black and white. Red Hat does not have any right to place restrictions on the distribution of derivative works that they do not own the original copyright for. Threatening to terminate a service agreement is a restriction.

From what I understand, these restrictions only apply to if you have been provided the software. Red Hat is under no legal obligation to supply you with their software, nor to continue doing so if you violate their terms.

I agree this makes them total scumbags, but as far as I understand the GPL they are not breaking the law.

Nothing a fork or two won’t solve.

Canonical has their own problems right now… Not a lot of snap fans out there. Canonical seems determined to skate to somewhere their users don’t live and create a world they don’t want.

Red Hat died the day IBM bought them. All that garbage about “leaving Red Hat alone” was of course total nonsense. IBM is doing what it does best – squeeze its existing customer base for short term gains. This won’t be the last thing Red Hat does that makes people annoyed.

Nix and Common Lisp seem to sit in the same space – it’s spoken of extremely fondly but has difficulty escaping the lab. For some reason it’s extremely technically capable, but fails to find widespread adoption.

Debian stable. The mix of having a stable host but being able to pull in flatpak / appimage / docker containers with newer software is awesome.

This instance rocks. Cheers to the admins.

because COMMUNISM