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.

I wonder how anyone stereotyping individuals based on far-distant ancestors square up these beliefs with hominid evolution. I guess the answer is “they don’t”.

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.

Spanish would be a good description of your ethnic background in that situation, but there are quite a number of ethnic identities within Spain as well - the Basque, Galicians and Catalans, just to name a few. “Spanish” isn’t a racial monolith. There would be plenty of people whose ethnic background looks quite different to yours but who are no less Spanish.

But none of that is mutable, is it?