php / php/doc-ru

Changelog for Throwable uses "Класс" instead of "Интерфейс"

Open Beginner friendly
#1,888 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
XML
Stars
60
Forks
83
Avg merge
7d 9m
Merged PRs (30d)
15

Description

From manual page: https://php.net/class.throwable


Описание проблемы

В официальной документации PHP на странице интерфейса Throwable
(https://www.php.net/manual/ru/class.throwable.php) в таблице
«Список изменений» указано:

Версия Описание
8.0.0 Класс Throwable теперь реализует интерфейс Stringable.

Однако Throwable — это интерфейс, а не класс. Формулировка
«Класс Throwable» вводит в заблуждение читателей, которые могут
воспринять Throwable как класс.

Ожидаемое поведение

Формулировка должна явно указывать, что речь идёт об интерфейсе,
например:

Версия Описание
8.0.0 Интерфейс Throwable теперь расширяет интерфейс Stringable.

или (если сохранять оригинальную формулировку из doc-en):

Версия Описание
8.0.0 Интерфейс Throwable теперь реализует интерфейс Stringable.

Технически корректнее — «расширяет» (extends), так как Throwable
сам является интерфейсом, а интерфейсы наследуют другие интерфейсы
через extends, а не implements.

Как воспроизвести
  1. Открыть https://www.php.net/manual/ru/class.throwable.php
  2. Прокрутить до раздела «Список изменений».
  3. Убедиться в формулировке «Класс Throwable…».
Предлагаемое исправление

Заменить в файле(ах) XML:

в [reference/.../class.throwable.xml](https://github.com/php/doc-ru/blob/master/language/predefined/throwable.xml)
заменить строки

<entry>
Класс <classname>Throwable</classname> теперь реализует
интерфейс <interfacename>Stringable</interfacename>.
</entry>

на

<entry>
Интерфейс <classname>Throwable</classname> теперь реализует
интерфейс <interfacename>Stringable</interfacename>.
</entry>

Готов оформить PR, если подтвердите, что формулировка требует правки.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open language/predefined/throwable.xml and locate the changelog entry for version 8.0.0. Compare its terminology with the English documentation and project conventions, update the Russian wording to identify Throwable correctly, then verify the rendered class.throwable.php page shows the corrected entry.

Written by the indexing model from the issue text.

Assessment

Tech stack
xml
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
92/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.