25
Naming Functions: When Intent and Implementation Differ
(chrisoldwood.blogspot.com)
Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!
Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.
Hope you enjoy the instance!
Rules
Follow the wormhole through a path of communities !webdev@programming.dev
I would use
reportMissingData
See, both
report
andrecord
signify different things in my mind. The original code was justprint
ing to stdout.In my mind
logMissingData
makes more sense because it's not actively sending anything; it's just logging.I agree that report and record are different. To me record means it's preserved in some managed way.
This makes it sound like the intent goes beyond logging, but not so far as recording. That's how I come to 'report' as the correct verb.
Agreed,
report
feels clearer as the verb "record" is more about permanent storage and later reference.Or even just
reportMissing
? Depending on what's happening around call sites, I often find I can drop generic stuff like "Data" and it's just as clear, especially when looking at a function signature. For instance: