language-agnostic - コード要素を通常のテキストにどのように組版しますか?

Question

読みやすさ、簡潔さ、および正確さのために引数を使用して関数をタイプセットする最良の方法は何ですか? func()関数の引数が実際にある場合でも、のように関数名の後に空の括弧を付ける傾向があります。引数を含めるのに問題がありますが、段落が読みやすいように感じます。

このためのベストプラクティスについて何か考えはありますか?

Answer 1

私は通常そのアプローチを取りますが、混乱を招くと思われる場合は、次のような省略記号を使用します。myFunction(...)

私が良ければ、テキスト内の関数からパラメーターを省略しているときはいつでもそれらを使用すると思います。

Answer 2

変数とパラメーターの名前にもう少し注意を払うだけで、ほとんどの人は、どのタイプのデータを保持したいかをより正確に推測できるようになります。