译自:https://lackofimagination.org/2024/10/self-documenting-code/,本文对原文内容进行二次修改。
前言
回想一下,你上次查看一段不熟悉的代码时的情景。你是否能够立刻理解它的功能?如果不能,不要担心——包括我在内的许多软件开发者都认为快速掌握陌生代码是一项挑战。
我们来看一个简单的 JavaScript 函数,它用于创建用户账户:
async function createUser(user) {
if (!validateUserInput(user)