В дополнении к правильному именованию переменных думаю стоит дописать правила именования файлов.
Файлы классов
Большинство разработчиков объектно-ориентированных приложений используют такое соглашение именования файлов, в котором каждый класс хранится в отдельно созданном для него файле. Одной из наиболее при этом досаждающих деталей является необходимость писать в начале каждого скрипта длинный список подгружаемых файлов.
Постфиксы
Примеры на языке PHP, но они также применимы и для многих других языков.
- Постфикс для файла класса: «.class.php».
- Постфиксы файлов с одной функцией: «.function.php», «.func.php».
- Постфиксы файлов с различным подключающимся дополнительным кодом: «.inc.php», «.includes.php».
Выбор директории для проекта
Раз уж мы заговорили про файлы и их именования, то расскажу про правильный выбор директории для рабочего проекта.
Какие требования?
- В пути должна быть только латиница. Некоторые программы не работают с другими алфавитами.
- Никогда не работать с проектом, находящимся в папке синхронизации облачного сервиса. В папке системы контроля версий — пожалуйста, но не в коем не случае не в папке синхронизации облачного сервиса.
- Выбрать надёжный диск/том. В ОС Windows диск C является не лучшим решением для папки рабочего проект т.к. можно нечаянно удалить при переустановке ОС.