Хороший код - его собственная лучшая документация. Когда вы собираетесь добавить комментарий, спросите себя: «Как я могу улучшить код, чтобы этот комментарий не нужен?» Улучшите код, а затем документируйте его, чтобы сделать его еще более ясным.