Вступительная страница инструмента перевода отправляет к мертвому списку рассылки

[mmalferov]

Вступительная страница русского инструмента перевода

http://doc.php.net/revcheck.php?lang=ru

предлагает присоединиться к команде переводчиков PHP-документации
на русский язык через список рассылки: [email protected]

Но страница списка php.doc.ru говорит, что список закрылся и больше
не принимает ни подписчиков, ни новые публикации:

https://news-web.php.net/php.doc.ru

Может быть, на вступительной странице вместо упоминания мертвого списка рассылки
оставить инструкцию, которая пригласит на Гитхаб
и посоветует отправлять исправления сразу со страниц документации? :-)

[saundefined]

Хм... какая-то ошибка, наверное.
Остальные списки активных языков остались рабочими, сейчас уточню.

[saundefined]

В любом случае, страницу можно переработать,
слак, думаю, смело можно уже убирать, по списку рассылки подождём ответа.

[saundefined]

@mmalferov спасибо, что заметил недоступность списка рассылок – поправили :)

[mmalferov]

Пока исправил страницу вот так: http://doc.php.net/revcheck.php?lang=ru

Готов изменить или добавить содержание, если что-то упустил ;-)

Не нашел способа разбить текст страницы на абзацы лучше, чем заинлайнить span-элементы со style-атрибутами: исходный код, который обрабатывает страницу, вставляет содержание intro-тега в p-элемент:

https://github.com/php/web-doc/blob/a642d7846b8f34d2d23f9bcc49f7bfb5663e3f7e/www/revcheck.php#L445

чем не дает нормально отформатировать страницу. Теги <para> или <simpara> в документе не обрабатываются.

Включение div-элементов внутрь p-элементов нарушает семантику, поэтому остановился на тегах span, поскольку других тегов не нашел, а текст без разбивки на абзацы затрудняет чтение; читатель не виноват ))

Было бы проще, если бы обработчик страницы оборачивал intro-содерание в тот же div. Тогда получилось бы обернуть текущее содержание тега intro в каждом языке в тег p, чтобы не нарушить вывод текущей разметки (я бы это руками сделал за 5 минут и отправил PR). И тогда бы на выходе разметка intrl-блока выглядела вот так, например, для французской версии:

<div>
  <p>
    Ceci est le fichier généré par phpdoc-fr/scripts/revcheck.php.
    Il vous permet de voir rapidement quels sont les fichiers qui
    doivent être mis à jour ainsi que la personne qui s'en occupe.
  </p>
</div>

Тогда разбивай вступительную страницу на абзацы без span'ов с инлайн-стилями =)

Ну или а) не бить на абзацы и мучить читателя, или б) оставить span'ы. Хотя лучше всё-таки подумать, как сделать удобно каждому: и тем, кому достаточно одного абзаца, и тем, кому требуется два и больше ))