3 ms·
Not all software development is like this. In some sectors it's treated as a proper engineering discipline. Circles where javascript, node and logging into Twit
by sidlls 9y ago
Not all software development is like this. In some sectors it's treated as a proper engineering discipline. Circles where javascript, node and logging into Twitter are a thing are where you find this casual indifference to documentation, garbage interfaces, dozens of competing APIs and so forth. The reason is straightforward: in these areas the problems are neither interesting nor that hard, and so developers get bored and invent complexity where it need not exist.
- ssd532 9y agoI have seen the same incomplete and inconsistent documentation for many Google and Microsoft projects including Kubernetes and many cloud based services. And it is not only about their REST APIs but for their SDKs for programming languages/frameworks not limited to Javascript/Node.
- hobofan 9y agoWhy would it be different for Google or Microsoft projects? I think sidlls was talking about industries where lives are at stake, like aviation , where things move slowely and follow a strict QA process. There you have formally verified systems and the like, but you also have to make tradeoffs like working with a limited subset of C because that is formally verifiable.
- ssd532 9y agoI completely agree on that part. I wanted to highlight that at least the bigcos should provide consistent and comprehensive documentation for their popular libraries/APIs.