Как набирать элементы кода в обычный текст?
Как лучше всего набрать функцию с аргументами в пользу удобочитаемости, краткости и точности? Я обычно ставлю пустые скобки после имени функции, например func(), даже если для функции действительно есть аргументы. У меня проблемы с изложением аргументов, но я все еще чувствую, что абзац читается.
Есть какие-нибудь мысли о лучших практиках для этого?
Ответы 2
Я бы просто был немного осторожнее с именами моих переменных и параметров, тогда большинство людей сможет гораздо точнее угадать, какой тип данных вы хотите в нем хранить.
Обычно я использую этот подход, но если мне кажется, что это вызовет путаницу, я использую многоточие, например: myFunction(...)
Думаю, если бы я был хорош, я бы использовал время любой, когда я пропускал параметры из функции в тексте.