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.
yarr
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.
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.
Your experience mirrors mine, where you must refer to the Rust and/or JS code to have a chance in hell.