DEV Community

Discussion on: Ever been stumped by <E>, <T>, <K, V> in OO language documentation?

Collapse
 
sandordargo profile image
Sandor Dargo

Thanks for the article. This reminds me of a code review I was part of.

It was C++ code, involving some templates. Something like this:

template <
    class C, // Something meaningful
    class R, // Something else meaningful
    class D, // Something explaning D well
    class H  // And again
>
class MyClass {
// ... quite some quantity of code...
};

I asked the question if they thought about removing the comments and use meaningful names instead. The answer was: "yes we thought about it, but decided not to".

Well...

Should code read like well-written prose?