- однородные сущности должны грепиться, но не обязательно базовый класс должен грепиться тем же запросом
- стремимся к размеру не более 40 литер (чтобы хотя бы 3 имени влезало на строку, которая на современном мониторе имеет ширину порядка 120 литер)
- поиск будет сделан со стеммингом, чтобы имя грепалось, даже если оно поставлено в словоформе.
- допустимы знаки препинания: ¡¿˛ˉ«» - соответственно, изображают !?,-
- если смысл - словосочетание, то склоняем
- часто повторяемые куски можно сокращать, можно обрезать окончание (согласно стеммингу) или использовать аббревиатуры. При обрезании конца слова стараться, чтобы урезанное слово читалось без особой подготовки (сразу думаем о возможных неоднозначностях)
- ЯП АО является чувствительным к регистру идентификаторов
- идентификатор может быть словосочетанием. При его чтении он бьётся на слова, с помощью заглавных букв, знаков препинания и символа подчёркивания. Правила, как происходит этот разбиение, кажутся с начала интуитивно понятными, однако для цифр и аббревиатур эти правила весьма нетривиальны. Их необходимость, и сами правила описаны в комментариях в файле ЛексерДляПоискаВФайле.ярм, и там же есть код, который умеет их разбирать. Примеры можно найти в тестах для этого модуля (в конце).
- параметры экспортируемых процедур должны быть с большой буквы. Причина - они часто совпадают с возможными будущими ключевыми словами
- в остальных случаях, первую букву первого слова можно делать большой или маленькой для целей выражения. Например, иногда принято, что тип пишется с большой буквы (т.к. это имя собственное), а имя переменной, одноимённое типу - с маленькой.
- у объявления сущности, видимой за пределами модуля (а лучше - и у локальной) должен быть доп. атрибут "полное название", в котором все сокращённые слова и аббревиатуры расшифрованы (надо добавить его в компилятор!)
Для перевода мы должны поискать (в порядке убывания приоритета), как это же понятие переведено в: В этой теме важен только ПОСТ, обсуждения не важны!