4 ms·
I'm not sure if this is positive or negative. But somehow more or less encouraged JavaScript community move towards: 1. Minimal interfaces 2. Better documentat
by namelosw 8y ago
I'm not sure if this is positive or negative. But somehow more or less encouraged JavaScript community move towards:
1. Minimal interfaces
2. Better documentation
Say like React although the codebase is more or less difficult to read. But the most useful surface-level APIs are quite minimal and intuitive. There are more minimal libraries follow this pattern.
And for the documentation -- probably because of the minimal interfaces, successful JavaScript libraries tend to have better documentation over most of the languages. A lot of documentation with both quick start guide and great higher level design or motivation explanation, instead of just generating doc from comments.
I think that's why this community is moving fast forward because people trying to be communicative, and constantly trying to simplify and introducing new ideas. It's very hard for people just read the code to understand some brand new concepts without a good understanding of the high-level constructs.
- nnq 8y ago..that's like saying: "We're proud to have the best the anti-suicide-by-jumping building meshes system and workplace psychiatric counseling in the world! The world record rate of suicide amongst our employees prompted us to implement and perfect this measures to such a high degree, that now we're considering to pivot our entire business model towards selling 'employee suicide prevention consulting services', since nobody has more experience than us with this!" (But jokes aside, yeah, you're right, there's lots of JS libs with much nicer interfaces and docs than Python ones, I agree...)
- moosingin3space 8y agoThis is a rather tasteless joke.
- nnq 8y agoIn retrospect I'd delete it if I could. I was imagining it inside a Dilbert cartoon in my head and it seemed funnier than it was. Again, I'm sorry for it, mental health issues are not a joke, I should know that. And I should also know that the tech community finds them less funny than others do, and for valid reasons. (...hanging out with ppl from the healthcare field made me too used to cruel/gross/insensitive/politically-incorrect/borderline-sadistic jokes, always forget that the rest of the world is less desensitized to death and suffering than us :P)
- adrianhel 8y agoThis is so true. Written documentation explaining the intent of 3rd party libraries is crucial. Comments as documentation is horrible to work with!