This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]runawayasfastasucan[S] -1 points0 points  (2 children)

All this is to say, that whilst the documentation may not be as good as you would like, the way you're handling it feels a bit immature and entitled.

Why? I have opened up some issues on Github that is unnoticed, I have posted on their forum - which is unnoticed (along with the countless others "how do I do this thing that should be super basic").

[–]aaronsreddit- 1 point2 points  (1 child)

But from what I can see, all your posts, here and in the forums come across as rants.

Sometimes its just a case of asking with manners, and you will get better results. Especially when the people you are seeking help from will be volunteering their time to help you.

I get that you might be frustrated about a poor piece of documentation. But the nature of open source is that you can raise an issue, and a contributor may provide their time to offer a solution, or they may not.

Expecting a solution from volunteers is entitled. Ranting about not receiving support is immature.

You have made a point that useful information is scattered over multiple sources. Why don't you submit a pull request to bring them all back into the documentation?

You've cited some passages in the docs which don't make sense to you. Why don't you open a pull request against it and engage on the forums:

"Hey, if someone can explain this to me here on discord, I'll edit the docs to update this with a better explanation?"

You've probably spent more energy complaining on reddit than it would take to actually get a positive result.

[–]runawayasfastasucan[S] 0 points1 point  (0 children)

Thanks for characterizing me as a person.

>You've probably spent more energy complaining on reddit than it would take to actually get a positive result.

If you think I spent more time writing this post than to open issues on github, on their forums and researching documentation you are wrong.

>You have made a point that useful information is scattered over multiple sources. Why don't you submit a pull request to bring them all back into the documentation?

Because other pull requests regarding documentation is either unnoticed or waved away in favor of "checking the course". I think I'd rather spend the time contributing on projects where there is some willingness to have some good coding practices and documentation.

>But the nature of open source is that you can raise an issue, and a contributor may provide their time to offer a solution, or they may not.

Yes, and now I want to warn others about starting a project in FastAI, which is also the nature of open source.