YES

get off my lawn

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?

Sorry, we had to deny your application because you’re Asian. Try another school.

Reddit comment threads are currently just full of groupmind wankery. I like being on a platform where I don’t 100% agree with everyone and I don’t have to hold “sanctioned” opinions that are approved by a mod team of 3.

But if I block everyone I disagree with, I won’t have to censor anyone!

Bahaha… “Anything I can’t argue my way out of” = hate speech

What about Leviticus 20:13? Is that hate speech?

and eventually it most likely would be by someone

Err, this has already happened quite a few times.

What if my ideas are so fragile that mere exposure to a contrasting opinion makes them crumble?

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.

The new model is “fuck you, pay me”

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.