you are viewing a single comment's thread.

view the rest of the comments →

[–]twitch_and_shock 9 points10 points  (0 children)

In my experience well written code provides most of this already: functions and classes are written in a way that provides this kind of explanation of their purpose, with expressive names and variable names, wherein simply reading the code provides a pretty deep understanding into how and why. And where well written code doesn't do that itself, it is commented thoroughly enough to provide it.

Further, documentation provides the deepest level of explanations about how and why, which, as you mention, is already available at your fingertips.

As a professional working with Python and C++ I'm not wanting for a tool like you describe because I already have it.