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?

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.

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.

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.

Reddit still has hundreds of millions of active users per month. They may have lost some people, but this many eyeballs has a huge potential for profit.

Taking bets:

• Participating in a competitive event where bathroom breaks are minimal or non-existent, such as a long-distance, multi-day gaming or eSports tournament.
• Attending a religious or spiritual retreat where fasting or avoiding certain bodily functions is part of the practices or rituals.
• Engaging in a survival challenge or a bet where the person has to limit food intake and avoid defecating for a certain period of time.
• Undergoing a specific medical procedure or test that requires limiting food intake and avoiding bowel movements for a few days.
• Participating in a scientific experiment or study where they have to control their diet and bowel movements.
• Partaking in a performance art piece or protest where he’s limiting his bodily functions as part of the statement.
• Attending an event (like a music festival or convention) where bathroom facilities are notoriously unclean or inconvenient, and they want to avoid using them as much as possible.
• Embarking on a long journey where bathroom facilities may not be readily available or convenient, such as a cross-country road trip or sailing expedition.
• Participating in a reality TV show or film production where bathroom breaks are limited or inconvenient.
• Engaging in a personal challenge or self-imposed discipline practice related to endurance or minimalism.

Because MONEY and lack of choice in some markets… easy.

I’m curious why this is classified as “losing battle”… seems pretty successful so far to me.

Sure, but it’s easy for a human to come up with semi-original prompts and then the content is good enough for some random magazine…