php / doc-ru

Russian translation of the PHP documentation
51 stars 73 forks source link

Исправление названия примеров в магических методах #974

Closed RuZniki closed 4 months ago

RuZniki commented 5 months ago

В первом примере заголовок отличается от содержания примера.

Использовал перевод похожий на французский "Utilisation de sleep() et wakeup()".

RuZniki commented 5 months ago

@mmalferov спасибо большое за обратную связь. Я склоняюсь к 4 предложеному варианту с небольшими изменениями.

Мне кажется избыточным добавления слова "пример" в начале, потому что во время рендинга, перед заголовком добавляется префикс "Пример №1" https://www.php.net/manual/ru/language.oop5.magic.php#example-796 image

Изначально я обратил внимание только на заголовок первого примера, но сейчас я понял что по хорошему надо заголовки все проверить. Заголовоки 4 и 5 разные.

Я предлагаю все заголовки привести к единообразию и использовать шаблон "Использование sleep() и wakeup()".

saundefined commented 5 months ago

Я тоже за 4 вариант, спасибо!

Мне кажется избыточным добавления слова "пример" в начале, потому что во время рендинга, перед заголовком добавляется префикс "Пример №1" https://www.php.net/manual/ru/language.oop5.magic.php#example-796

В #256 есть предложение по унификации заголовков примеров на «Пример использования ...», хотя в примере речь о функции, неплохо было бы привести к однообразию все заголовки: «Пример использования <функции/метода/константы/языковой конструкции/и т. д.> <сущность>».

RuZniki commented 5 months ago

Обновил заголовок первого пример.