the-documentation-compendium/ru/CODING_GUIDELINES.md

# Гайдлайн по написанию кода

- Вы можете проверить, соответствует ли ваш код этому гайдлайну, запустив `stuff/php-format.py validate`
- Табуляция, без пробелов
- Конец строки должен быть в стиле Unix (`\n`), а не в стиле Windows (`\r\n`)
- Открывающие скобки находятся в той же строке, что и последний оператор.

```
    if (condition) {
        stuff;
    }
```

- Пробел между ключевыми словами и круглыми скобками для: `if`, `else`, `while`, `switch`, `catch`, `function`
- В вызовах функций нет пробела перед круглыми скобками
- В скобках нет пробелов
- Пробел после каждой запятой, но без пробела перед
- Все бинарные операторы должны иметь один пробел до и один после
- Не должно быть более одной непрерывной пустой строки
- Пустых комментариев быть не должно
- Вы не должны использовать блоки комментариев `/ * ... * /`, только строку `// ...`
- Изменения в функциональности должны сопровождаться соответствующими новыми/ модифицированными тестами
- Исключения должны использоваться для сообщения об ошибочных состояниях. Использование функций, возвращающих true/false, разрешено, когда они являются ожидаемыми значениями
- При необходимости используйте [RAII] (http://en.wikipedia.org/wiki/Resource_Acquisition_Is_Initialization), в основном при администрировании ресурсов (файлов и т. д.)