3 ms·
I have seen the same incomplete and inconsistent documentation for many Google and Microsoft projects including Kubernetes and many cloud based services. And it
by ssd532 9y ago
I 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.