Какие бы правила мы ни использовали сегодня, чтобы сделать наш код более читабельным, через 10 лет это будет выглядеть старомодно и глупо. Если вам действительно нужна лучшая читаемость кода, прочитайте какой-нибудь старый код (учтите, сколько времени ему нужно для работы на машине с тысячной скоростью и памятью), постарайтесь понять его и поощрить кого-то другого сделать то же самое.
дело доходит до документации кода, обычно считается, что код долженобъяснии документация встроенного кода (исключая общедоступную документацию API) должна только объяснять проблемы метакода, такие как обходные пути, объяснения, почему были выбраны определенные реализации, и т. д.
Как вам сделать ваш код более читабельным и болееобъясняя себя?
Редактировать: Помимо общих комментариев, я также ищу конкретные советы. Поэтому, если вы говорите «короткие, но значимые имена переменных», было бы неплохо также получить полезный совет (например, «использовать принцип трех слов»).