Неправильный порядок слов в названиях или неестественное их сочетание усложняет чтение. Слова должны располагаться в том порядке и сочетании, в котором они были бы расположены в правильной английской речи.


Пример 1

Плохо:


num_active_users = ...

Хорошо:


active_users_num = ...


Пример 2

Плохо:


def user_info_get(user_id):
...

Хорошо:


def get_user_info(user_id):
...


Пример 3

Плохо:


class ConverterCurrency:
def __init__(self, exchange_rate):
    self.exchange_rate = exchange_rate

def convert_amount(self, amount):
    return amount * self.exchange_rate

Хорошо:


class CurrencyConverter:
def __init__(self, exchange_rate):
    self.exchange_rate = exchange_rate

def convert_amount(self, amount):
    return amount * self.exchange_rate


Пример 4

Для английского языка такое словосочетание является неествественным.

Плохо:


class EmployeePerson:
...

Хорошо:


class Employee:
...


Пример 5

Плохо:


def get_statistics_salary(all_vacancies):
...

Хорошо:


def get_salary_statistics(all_vacancies):
...


Пример 6

Плохо:


def soon_birthday(args):
...
return birthday_datetime

Хорошо:


def calculate_birthday(args):
...
return birthday_datetime


Пример 7

Плохо:


ENABLE_CALCULATE_COMMISSION_APPLICATION: bool = Field(...)

Хорошо:


ENABLE_APPLICATION_COMMISSION_CALCULATION: bool = Field(...)


Пример 8

Плохо:


ENABLE_CALCULATE_INCOME_RUB_DEAL: bool = Field(...)

Хорошо:


ENABLE_DEAL_INCOME_RUB_CALCULATION: bool = Field(...)