Трудности перевода в коде

Совершенно согласен. Такие опечатки (и ошибки) очень отвлекают (даже мне, «izobrazhenie» — просто ад). Я когда-то читал португальскую либу, если бы хоть методы были английскими — было бы проще

>...izobrazhenie… Что будет ощущать англоговорящий разработчик, читая этот код?
Он будет искать класс zobrazhenie, который реализовывет этот странный интерфейс.

> идеальным вариантом было бы назвать метод getChildren.

Не всегда. В разных языках/техниках/проектах приняты разные принципы именнования get'еров. Где-то принято с get, а где-то без.

Читабельность — одно из самых важных свойств хорошего кода. Если не самое важное. Мы тратим на чтение кода гораздо больше времени, чем на его написание. Потому лучше посидеть чуть подольше и написать читабельный код, зато потом гораздо больше времени уйдет на его чтение.
Кстати, комментарии на французском — не проблема. Проблема — комментарии вообще. Если их много, значит сам код, скорее всего, не читабельный.

Припоминаю, игрался когда-то с исходниками Doom'а. Так вот, там — а они американцы! — было VERTEXES, при правильном vertices.

Parse error: syntax error, unexpected T_PAAMAYIM_NEKUDOTAYIM in /index.php

Сомневаешься в правильности написания названия переменной?
Назови ее просто: asd123.

Плотно работая с немецким коллегой договорились комменты (кроме тривиальных phpdoc и т. п.) писать на родном для каждого языке, причём соблюдая (стараясь соблюдать) все правила грамматики и избегая (стараясь избегать) всяких «сложноподчиненных деепричастных оборотов» ©, но сущности именовать на английском, причём тщательно проверяя в словарях прямой и обратный перевод. Причина первого — онлайн-переводчики не очень адекватно переводят с немецкого на русский или наоборот через английский, напрямую куда лучше.

То есть если я перевожу с русского на английский через, скажем, гугл, то на мой взгляд вполне корректная английская фраза получается, и даже на при переводе её обратно на русский получается более-менее понятно (мне :) ). Но он говорит, что на немецком полная абракадабра получается при переводе английского перевода. Если же он переводит с русского на немецкий напрямую, то говорит, что более-менее понятно. Аналогично с его стороны.

В общем проще писать комменты на родном языке, стараясь сознательно облегчить задачу для машинного перевода (не употреблять сленг, идиомы, фразеологизмы, аббревиатуры, писать грамотно и стараться не употреблять сложные формы слов и предложений), чем писать их на ломаном английском, а потом на ломаном же английском пытаться объяснить что имелось в виду (если будет такая возможность).

Насчёт именования: Однозначно на английском, но если пришлось лезть для этого в словарь или переводчик (то есть слово не распространенное в программировании), то тщательно проверять обратный перевод. А то может получится так, что прямой перевод на английский русского слова однозначно обратно не переводится и «оригинал» далеко не самое распространенное значение. Иногда по 15 минут приходится подбирать пару «русский» — «английский», чтобы использовались самые распространенные значения в обоих языках.

Следует переучить англичан говорить childs. Множественное: единственное + 's'. А все исключения оставить для высокопарного литературного стиля.

Проблема s в конце для слов во множеством числе решается элементарным образом. Пишется слов в единственном числе, далее следует суффикс list.

$children_list = getChildrenList() {...}
foreach ($children_list as $children) {}

Получаем следующие профиты:
1) s в конце это один символ, визуально при чтении кода такой нюанс можно пропустить, слово list более нагляден (в примере выше это видно в foreach-е);
2) не нужно думать о правилах образования множественного числа, добавить в конце слова тупо s можно не всегда;
3) уходят проблемы для слов подобных news:

$news_list = getNewsList() {...}
foreach ($news_list as $news) {}

list — всегда массив. Методы при этом всегда должны возвращать массив, переменные всегда содержать массив.

Следование этому правилу упрощает поддержку кода даже в случае единственно разработчика.

Даёшь переводчик кода :)

Всегда пользуюсь переводчиком или словарем, когда не могу подобрать нужное слово по-английски.

Ради юмора я как-то написал забавный класс на PHP и применял исключительно кириллицу, где это было возможно.

class Чайник {
const ВРЕМЯ_КИПЯЧЕНИЯ = 300; //сек

public function Включить () {
//…
$this->_ВыключитьАвтоматически();
}

public function Выключить () {
//…
}

private function _ВыключитьАвтоматически() {
//…
}
}

В общем враг не пройдёт )))

P.S.: естественно, это НЕ «боевой» код, но вполне рабочий )))