Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

You’ve never told (or been) a new employee to step through the code to figure out what isn’t in the docs?

There’s a middle ground that you see with a number of test frameworks, Gulp, SCons and I suspect with Pulumi, where the outer shell of imperative code is in practice declarative, and the inner bits are properly imperative.

Part of the code says why to do something, and the rest says how to do it. For instance I don’t see a huge conceptual difference between disabling or filtering a test, versus not deploying a service because it is running, current, and healthy.



> You’ve never told (or been) a new employee to step through the code to figure out what isn’t in the docs?

To me that sounds like a failure state.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: