4 ms·
Kubernetes for Golang. This has been brought up as an example of fine documentation: https://github.com/kubernetes/kubernetes/blob/ec2e767e59395376fa191d7c56a74
by myth_buster 7y ago
Kubernetes for Golang.
This has been brought up as an example of fine documentation:
https://github.com/kubernetes/kubernetes/blob/ec2e767e59395376fa191d7c56a74f53936b7653/pkg/controller/volume/persistentvolume/pv_controller.go#L54 https://github.com/kubernetes/kubernetes/blob/ec2e767e593953...
Requests for Python
https://github.com/psf/requests https://github.com/psf/requests
- snazz 7y agoI’m not sure I’d call Space Shuttle Style appropriate for 99% of code, but it does make it easy to read and harder to mess up down the road.
- sterlind 7y agoSpace Shuttle Style is appropriate when the design is fixed, the code is extremely tricky and it's very difficult to test - in other words, when it's not possible to follow normal good coding practices. If you can comprehensively test, then the docs can live there, and you don't need quite so many warnings about introducing bugs.
- otterley 7y agoK8S was transpiled from Java, and it shows. Much of the code isn't idiomatic Go at all. So I wouldn't cite K8S as a shining example. Comments like the one cited are fantastic, but we're interested in examplars of good (i.e., elegant and readable) code, not ancillary matter.
- luminati 7y agoVery interesting! I never knew that! Did a bit of googling to verify it. [1] [1] https://fosdem.org/2019/schedule/event/kubernetesclusterfuck/ https://fosdem.org/2019/schedule/event/kubernetesclusterfuck...