Learn More
Resend Email
16
12bitfloat
3y

** PSA to all programming language and tool maintainers **

Please for the love of god have a dedicated examples section on your website where people can quickly evaluate what the thing even looks like

So often the next best thing is going to the docs where they tell you that the turboblub option should be set to 12 in these specific usecases whEN I DON'T eVEN KNoW WHETHER THIS IS A PROGRAMMING LANGUAGE OR A LAWN MOWER

rant

docs

wth

psa
Favorite
Ranter
Comments
  • 4
    3y
    And please including examples for all non-trivial parameters, not just your API's hello world, leaving people to figure it out on their own based on 3 year old, deprecated SO answers.
  • 1
    3y
    Amen bro.

    I haven't looked much closer but i was browsing this site recently:

    https://www.papaparse.com/

    I really liked their question + answer and then expand on it type layout to just ... get a feel for what the shape of their code is in terms of how I might use it.
  • 1
    3y
    Agreed, this is a huge problem that I see over and over again.
Related Rants
devRant © 2021 Hexical Labs LLC
Privacy Policy  |  Terms of Service
Add Comment