Changelog for Throwable uses "Класс" instead of "Интерфейс"
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.
Как воспроизвести
- Открыть https://www.php.net/manual/ru/class.throwable.php
- Прокрутить до раздела «Список изменений».
- Убедиться в формулировке «Класс 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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