4 ms·
Every identifier in the system is a bit of documentation. I submit that there's a difference when you name a function: bool ufklsjblsboabfds(int, int) and b
by lallysingh 10y ago
Every identifier in the system is a bit of documentation. I submit that there's a difference when you name a function:
bool ufklsjblsboabfds(int, int)
and
bool operator<(int, int)
I know that to many, the idea of individual identifiers being documentation is a bit radical, but I think it's the first documentation a developer sees. It's the documentation built into the body of every piece of code that they read and write.
- GavinMcG 10y ago> I know that to many, the idea of individual identifiers being documentation is a bit radical I think the opposite – it's totally mundane to most people. Aside from the intellectual exercise it requires, people don't have any reason to use a language that used bool ufklsjblsboabfds(int, int) any more than they would use Brainfuck. So, sure, the API "documents" the functionality in the most minimal way possible. But when you say "documentation" you're using a term that almost no one will understand in the way you mean it.