Date: Tue, 18 Jun 2019 09:49:54 +0000 (UTC) From: Ryusuke SUZUKI <ryusuke@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53166 - head/ja_JP.eucJP/articles/problem-reports Message-ID: <201906180949.x5I9nsGo033155@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ryusuke Date: Tue Jun 18 09:49:53 2019 New Revision: 53166 URL: https://svnweb.freebsd.org/changeset/doc/53166 Log: - Merge the following from the English version: r52112 -> r53150 head/ja_JP.eucJP/articles/problem-reports/article.xml Modified: head/ja_JP.eucJP/articles/problem-reports/article.xml Modified: head/ja_JP.eucJP/articles/problem-reports/article.xml ============================================================================== --- head/ja_JP.eucJP/articles/problem-reports/article.xml Mon Jun 17 22:18:56 2019 (r53165) +++ head/ja_JP.eucJP/articles/problem-reports/article.xml Tue Jun 18 09:49:53 2019 (r53166) @@ -3,7 +3,7 @@ "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">; <!-- The FreeBSD Japanese Documentation Project - Original revision: r52112 + Original revision: r53150 $FreeBSD$ --> <article xmlns="http://docbook.org/ns/docbook" @@ -221,13 +221,10 @@ <link xlink:href="&url.base;/security/"> サポートされているバージョンの一覧</link> を管理しています。</para> - <para>ある port に問題がある場合、まずはじめに Ports Collection - の最新版にアップグレードして、 - まだ問題が起きるかどうかを確認してください。 - これらのアプリケーションは速いペースで変更されるため、 - &os; で完全な最新版以外に対応するのは不可能です。 - アプリケーションの古いバージョンにある問題は、 - 直しようがありません。</para> + <para>ある port に問題がある場合、 + 開発元にバグを報告することを考えて見てください。 + すべてのソフトウェアのすべてのバグに対し、&os; + プロジェクトが修正することは不可能です。</para> </section> <section xml:id="pr-prep"> @@ -328,7 +325,7 @@ <para><emphasis><quote>Summary</quote>(概要) 行を空のままにしないでください。</emphasis> 障害報告は、世界中に配布されるメーリングリストに送られる - (そこでは、<quote>Synopsis</quote> (概要) は + (そこでは、<quote>Summary</quote> (概要) は <literal>Subject:</literal> 行に使われます) と共に、 データベースにも登録されます。後でデータベースを synopsis (概要) で参照する人は、 @@ -339,40 +336,35 @@ </listitem> <listitem> - <para><emphasis>わかりにくい<quote>Synopsis</quote> (概要) + <para><emphasis>わかりにくい <quote>Summary</quote> (概要) 行は避けましょう。</emphasis> あなたが提出した障害報告を読む人がどういう状況か分かっていると仮定すべきではありません。 できるだけ詳しく書きましょう。 たとえば、その問題はシステムのどの部分にあてはまるのでしょうか。 インストール中にしか問題に当たらないのか、それとも稼働中に当たるのか。 具体的な例でいうなら、 - <literal>Synopsis: portupgrade is broken</literal> + <literal>Summary: portupgrade is broken</literal> (概要: portupgrade がおかしい) ではなく、 次のように書いたらどれだけ伝わりやすいか考えてみてください。 - <literal>Synopsis: port ports-mgmt/portupgrade coredumps on + <literal>Summary: port ports-mgmt/portupgrade coredumps on -current</literal> (概要: sysutils/portupgrade port が -current でコアダンプします)。(ports の場合は、 - <quote>Synopsis</quote> (概要) 行に分類と名前を入れると、 + <quote>Summary</quote> (概要) 行に分類と名前を入れると、 とても助かります)。</para> </listitem> <listitem> <para><emphasis>パッチがあるなら、そう書いてください。</emphasis> パッチがついている障害報告は、 - ついていないものよりも見てもらえる可能性が高いです。パッチをつける場合は、 - <quote>Synopsis</quote> (概要) 行の先頭に - <literal>[patch]</literal> という文字列 (角括弧を含みます) - をいれて下さい。 - (この通り書かなければならないというわけではありませんが、 - 慣習としてこの文字列が用いられています)。</para> + ついていないものよりも見てもらえる可能性が高いです。 + Bugzilla の Keyword で <literal>patch</literal> + を選択してください。</para> </listitem> <listitem> <para><emphasis>あなたがメンテナなら、そう書いてください。</emphasis> ソースコードの一部 (たとえば、ある port) - をメンテナンスしているなら、概要行の先頭に - <literal>[maintainer update]</literal> - という文字列 (角括弧を含みます) をできればいれて、障害報告の + をメンテナンスしているなら、障害報告の <quote>Class</quote> を必ず <literal>maintainer-update</literal> にしてください。こうすれば、committer @@ -550,7 +542,8 @@ <section xml:id="pr-writing-before-beginning"> <title>始める前に</title> - <para><link xlink:href="https://bugs.freebsd.org/bugzilla/enter_bug.cgi">; web + <para><link + xlink:href="https://bugs.freebsd.org/bugzilla/enter_bug.cgi">; web ベースの障害報告提出フォーム</link> を利用する場合も、同様の配慮が必要です。 カットアンドペーストを行う場合には、 @@ -565,10 +558,11 @@ <title>パッチやファイルを添付する</title> <para>パッチを添付する場合、 - unified 形式の差分を &man.diff.1; の - <option>-u</option> オプションを使って作成してください。 + unified 形式の差分を <command>svn diff</command> または + &man.diff.1; の <option>-u</option> + オプションを使って作成してください。 開発者があなたの報告を読んで簡単にパッチを適用できるように、 - 修正したファイルの正確な + 修正したファイルに対するリポジトリの SVN のリビジョン番号が特定できることを確認してください。 カーネルやベースのユーティリティに関しては、新しいコードはすべて &os.current; (SVN の HEAD ブランチ) @@ -627,13 +621,6 @@ 概要は障害報告メールのサブジェクトとして利用されており、 一覧や要旨にも使われています。 概要が不明瞭な障害報告は無視される傾向があります。</para> - - <para>上述したように、障害報告にパッチが含まれているなら、 - 概要の先頭に <literal>[patch]</literal> (角括弧を含みます) - と書いて下さい。 - Ports に関する障害報告で、あなたがメンテナなら、 - <literal>[maintainer update]</literal> (角括弧を含みます) - を追加してください。</para> </listitem> <listitem> @@ -765,7 +752,7 @@ <literal>amd64</literal> (この分類には、EMT64 モードで動作する Intel 互換のコンピュータも含まれます) を選択してください。 通常はあまりよく使われないアーキテクチャには、 - <literal>arm</literal>, <literal>ia64</literal> および + <literal>arm</literal> および <literal>powerpc</literal> があります。</para> <note> @@ -849,16 +836,11 @@ 最初の報告の中で言及しなかったものを思い出したり発見したら、 フォローアップを提出してください。 バグが修正されない一番の理由は、 - 提出者とのコミュニケーション不足が原因です。</para> - - <itemizedlist> - <listitem> - <para>一番楽なのは、<link - xlink:href="https://bugs.freebsd.org/bugzilla/query.cgi">; - 障害報告検索ページ</link> から行ける、それぞれの障害報告の - web ページのコメントオプションを利用することです。</para> - </listitem> - </itemizedlist> + 提出者とのコミュニケーション不足が原因です。 + 一番楽なのは、<link + xlink:href="https://bugs.freebsd.org/bugzilla/query.cgi">; + 障害報告検索ページ</link> から行ける、それぞれの障害報告の + web ページのコメントオプションを利用することです。</para> <para>問題がなくなったのに障害報告の処理が完了していなければ、 できれば、どのように、いつ、問題を解決できたかの説明を添えて、
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201906180949.x5I9nsGo033155>