3 ms·
I have a pretty obvious codesmell test that I apply to software codebases, Can I achieve what I need just by reading the code? If not, it probably means there
by ehnto 5y ago
I have a pretty obvious codesmell test that I apply to software codebases,
Can I achieve what I need just by reading the code? If not, it probably means there is a bunch of arbitrary knowledge in configuration, transpiling, generation, linking, novel concepts or language "magic" that you will need to consult the docs for.
If a codebase is idiomatic to the language its written in you really should be able to figure most things out from reading the code. At the very least my IDE should know how to autocomplete functions in the codebase without generating helper files. The helper file is essentially a list of all the missing information in the codebase that someone has had to figure out how to generate and connect.