mailinglist.xml упростил стиль изложения

This commit is contained in:
Mikhail Alferov
2024-09-12 18:55:47 +03:00
committed by GitHub
parent 92b76e13c7
commit a6ed473c80

View File

@ -13,38 +13,39 @@
<qandaset>
<qandaentry xml:id="faq.mailinglist.isthere">
<question>
<para>Существуют ли списки рассылки PHP?</para>
<para>Существуют ли в PHP-сообществе списки рассылки?</para>
</question>
<answer>
<para>
Конечно! Существует множество списков рассылки на разные темы.
Полный перечень списков даёт страница
Конечно! Сообщество открыло много списков рассылки на разные темы.
Полный перечень списков доступен на странице
<link xlink:href="&url.php.mailing-lists;">списков рассылки</link>.
</para>
<para>
Адрес общего списка рассылки — <literal>php-general</literal>.
Чтобы подписаться на него, отправьте пустое письмо на адрес
<link xlink:href="mailto:&url.ml.general.subscribe;">&url.ml.general.subscribe;</link>.
Чтобы отписаться, отправьте пустое письмо на адрес
На общую рассылку подписываются путём отправки пустого письма на адрес
<link xlink:href="mailto:&url.ml.general.subscribe;">&url.ml.general.subscribe;</link>,
а чтобы отписаться, отправляют пустое письмо на адрес
<link xlink:href="mailto:&url.ml.general.unsubscribe;">&url.ml.general.unsubscribe;</link>.
</para>
<para>
Подписаться или отписаться на список рассылки также получится через веб-интерфейс на странице
Подписку и отписку также поддерживает веб-интерфейс на странице
<link xlink:href="&url.php.mailing-lists;">списков рассылки</link>,
а инструкции по отписке есть внизу каждого сообщения из рассылки.
а инструкции по отписке содержатся внизу каждого сообщения рассылки.
</para>
</answer>
</qandaentry>
<qandaentry xml:id="faq.mailinglist.others">
<question>
<para>Существуют ли другие сообщества?</para>
<para>Что насчёт других сообществ?</para>
</question>
<answer>
<para>
Бессчётное количество по всему миру. На странице <link
xlink:href="&url.php.support;">поддержки</link>, например,
есть ссылки на ряд ресурсов и информация о том,
PHP-энтузиасты создают в городах мира местные группы,
готовят встречи, открывают курсы по PHP и переписываются в чатах.
<link xlink:href="&url.php.support;">Страница поддержки</link>
содержит ссылки на отдельные сообщества и рассказывает,
как узнать больше.
</para>
</answer>
@ -56,10 +57,9 @@
</question>
<answer>
<para>
Конечно! На самом деле мы не только разрешаем это бесплатно, мы это поощряем!
Когда вы помогаете и делитесь знаниями и опытом по PHP с другими,
вы поощряете рост и разработку как глобального сообщества PHP, так и
языка.
Конечно! Мы свободно разрешаем и поощряем это.
Когда вы помогаете другим и делитесь знаниями о языке PHP,
вы помогаете глобальному PHP-сообществу и языку расти и развиваться.
</para>
</answer>
</qandaentry>
@ -67,81 +67,77 @@
<qandaentry xml:id="faq.mailinglist.subscribing">
<question>
<para>
Помогите! Похоже, я не могу подписаться или отписаться на один из списков рассылки.
Помогите! Похоже, я не могу подписаться или отписаться от рассылки.
</para>
</question>
<answer>
<para>
Наиболее распространенная причина, по которой не получается отписаться от
списков рассылки, — пересылка почты. Например, если
ваш адрес электронной почты <literal>elephpant@example.com</literal>, но вы
подписались на список рассылки с адреса
<literal>php-lists@example.com</literal>, который пересылает письма, и пересылаете письма на адрес
<literal>elephpant@example.com</literal>, попытка отписать адрес
<literal>elephpant@example.com</literal> не сработает, поскольку этот адрес
даже не известен нашим системам. Вместо этого вам нужно отписать
адрес, на который отправляется письмо, отправив письмо с
этого адреса, в этом примере — с
<literal>php-lists@example.com</literal>.
Часто отписаться от рассылки не получается из-за пересылки почты.
Пусть для сообщений списка рассылки требуется установить целевой адрес электронной почты
<literal>elephpant@example.com</literal>, но на список рассылки подписались с адреса
<literal>php-lists@example.com</literal>, который пересылает письма на адрес
<literal>elephpant@example.com</literal>. Попытка отписать адрес
<literal>elephpant@example.com</literal> не сработает, поскольку сервер рассылок
ничего не знает об этом адресе. От рассылки отписываются путём отправки письма
с того адреса, который подписали на рассылку. В этом примере письмо на адрес отписки
потребуется отправить с адреса <literal>php-lists@example.com</literal>.
</para>
</answer>
</qandaentry>
<qandaentry xml:id="faq.mailinglist.archive">
<question>
<para>Существует ли где-нибудь архив списков рассылки?</para>
<para>Хранится ли где-нибудь архив списков рассылки?</para>
</question>
<answer>
<para>
Да, список архивов можно найти на странице
<link xlink:href="&url.php.mailing-lists;">списков рассылки</link>.
Вы также найдёте дюжины сайтов, которые архивируют и (или) отдают
содержание наших списков рассылок в любимом вами поисковике.
Просто задайте вопрос «архивы списков рассылки по php» (php mailing list archives).
Да, список архивов доступен на странице
<link xlink:href="&url.php.mailing-lists;">списков рассылки</link>.
Содержание списков рассылки также архивируют и (или) распространяют десятки сайтов.
Материалы рассылок доступны в результатах поисковых систем по запросу
«архивы списков рассылки php» (англ. "php mailing list archives").
</para>
<para>
Статьи списков рассылки также архивируются в виде сообщений новостей.
Сервер новостей доступен по адресу <link
xlink:href="&url.php.news;">&url.php.news;</link> через
новостной клиент. Есть также
экспериментальный веб-интерфейс для сервера новостей, который доступен
по адресу <link
xlink:href="&url.php.newsweb;">&url.php.newsweb;</link>.
Статьи списков рассылки также архивируются в виде сообщений новостей.
Сервер новостей доступен по адресу <link
xlink:href="&url.php.news;">&url.php.news;</link> через
новостной клиент. Экспериментальный веб-интерфейс для сервера новостей
доступен по адресу <link xlink:href="&url.php.newsweb;">&url.php.newsweb;</link>.
</para>
</answer>
</qandaentry>
<qandaentry xml:id="faq.mailinglist.question">
<question>
<para>О чём я могу спрашивать в списке рассылки?</para>
<para>О чём разрешается спрашивать в списке рассылки?</para>
</question>
<answer>
<para>
С растущей день ото дня популярностью PHP, нагрузка на список рассылки
php-general увеличилась и на составляет от 75 до 200 и более
сообщений в день. Поэтому, в интересах всех, используйте список
С растущей день ото дня популярностью PHP нагрузка на список рассылки
php-general увеличилась и составляет от 75 до 200 и даже больше
сообщений в день. Поэтому в общих интересах использовать этот список
рассылки только в крайнем случае, когда поиски в других местах
не дали результата.
</para>
<para>
Прежде чем отправить сообщение в список, пожалуйста, просмотрите этот
FAQ и это руководство, возможно, в них вам удастся найти решение проблемы.
Если там не удалось ничего найти, просмотрите архивы списка (смотрите выше).
Если у вас проблема с установкой или настройкой PHP, пожалуйста,
прочтите сопровождающую документацию и файлы README. Если после всего этого
не удалось найти ответ, то ваш вопрос в списке рассылки более чем
желателен.
Перед отправкой сообщения в список рассылки, пожалуйста, прочитайте этот
FAQ и документацию к PHP, возможно, в них уже есть решение.
Просмотрите архивы списка (о них рассказывают предыдущие параграфы),
если не получилось найти помощь в руководстве по языку.
Прочитайте документацию и README-файлы, если появилась проблема
с установкой или настройкой PHP. Подпишитесь на рассылку и отправьте сообщение
в список по теме, если даже FAQ, документация и архивы списков рассылки не помогли.
</para>
<para>
Чтобы получить наилучший ответ (и чтобы не расстраивать ваших
собратьев-программистов), пожалуйста, проверьте, что отсылаете
вопрос в соответствующий список рассылки. Например, если возникла
проблема с установкой PHP, нужно отправить вопрос в список
рассылки <literal>php-install</literal>.
Предостережение: у некоторых списков похожие имена и совершенно
разные назначения; вопрос по работе PHP-скриптов в Windows
должен быть отправлен в пользовательский список рассылки — Windows PHP users,
а <emphasis>не</emphasis> список PHP разработчиков в Windows — Windows Internals list.
Чтобы получить наилучший ответ — и не разочаровывать
коллег-разработчиков, проверьте, что отправляете
вопрос в правильный список рассылки. Например, если появилась
проблема с установкой PHP, отправляйте вопрос в список
<literal>php-install</literal>.
Предостережение: отдельные списки называются похоже, но у них
совершенно разное назначение; вопрос по работе PHP-скриптов в Windows
требуется отправлять в список PHP-пользователей в ОС Windows — Windows PHP users,
а <emphasis>не</emphasis> список PHP-разработчиков для ОС Windows — Windows Internals.
</para>
<para>
Хорошая идея — прежде чем задавать вопросы, прочитать статью
@ -152,31 +148,30 @@
<qandaentry xml:id="faq.mailinglist.guideline">
<question>
<para>Какую информацию я должен включить при отправке в список?</para>
<para>Какую информацию лучше включить при отправке в список?</para>
</question>
<answer>
<para>
Сообщения наподобие «Не могу запустить PHP! Помогите мне! В чем дело?»
бесполезны. Если у вас проблема с запуском PHP, нужно
указать операционную систему, версию PHP, как вы его получили
(прекомпилированный, Git, RPM и т. п.), что уже сделали, на чём
остановились, и, если есть, точное сообщение об ошибке.
бесполезны. При проблеме с запуском PHP указывают операционную систему,
версию PHP, как получили версию (скачали предварительно скомпилированную, из Git, через RPM и т. п.),
что уже сделали, на чём остановились, и, если есть, точное сообщение об ошибке.
</para>
<para>
Это также относится к любой другой проблеме. Нужно указать, что вы
уже сделали, на чём застопорились, что пытаетесь делать и, если есть,
любые сообщения об ошибках. Если проблема с исходным кодом, который вы написали, то
надо включить фрагмент кода, который не работает, и указать проблемную строку,
сопроводив её правильным комментарием. Но не пытайтесь отправить
больше, чем надо! Иначе ваше сообщение будет тяжело читать и большинство
людей его просто пропустит. Если трудно решить, какой объем
информации достаточен, отправьте столько, сколько нужно по
текущей проблеме, и приготовьтесь выслать больше информации по запросу.
Это также относится к любой другой проблеме. Нужно указать,
что уже сделали, на чём остановились, что пытаетесь делать и, если есть,
сообщения об ошибках. При проблеме с исходным кодом, который написал сам пользователь,
включают фрагмент кода, который не работает, и указывают проблемную строку,
которую сопровождают правильным комментарием. Не отправляйте
больше, чем требуется! Иначе сообщение станет сложным для чтения и бо́льшая часть
людей просто пропустит письмо. Когда трудно решить, какой объем
информации достаточен, отправляют только то, что касается
текущей проблемы, и готовятся отправить больше информации по запросу.
</para>
<para>
Другая важная вещь, которую стоит помнить, это краткое изложение вашей
проблемы в строке темы сообщения. Заголовки типа «ПОМОГИТЕ МНЕЕЕ!!!» или
«В чём здесь проблема?» проигнорирует большинство читателей.
Другая важная вещь, которую лучше не забывать, краткое изложение проблемы
в теме сообщения. Заголовки наподобие «ПОМОГИТЕ МНЕЕЕ!!!»
или «В чём здесь проблема?» проигнорирует бо́льшая часть читателей.
</para>
<para>
И напоследок, для общей пользы и особенно для вас,