Pārlūkot izejas kodu

manual: contributing: minor rewording of 'reporting bugs' section

This patch makes some minor fixes in the section about reporting bugs.

Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Acked-by: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Thomas De Schampheleire 11 gadi atpakaļ
vecāks
revīzija
1c97e35f9b
1 mainītis faili ar 13 papildinājumiem un 8 dzēšanām
  1. 13 8
      docs/manual/contribute.txt

+ 13 - 8
docs/manual/contribute.txt

@@ -274,16 +274,16 @@ $ git format-patch --subject-prefix "PATCH v4" \
 ---------------------
 ---------------------
 
 
 [[reporting-bugs]]
 [[reporting-bugs]]
-Reporting issues/bugs, get help
--------------------------------
+Reporting issues/bugs or getting help
+-------------------------------------
 
 
 Before reporting any issue, please check
 Before reporting any issue, please check
 xref:mailing-list-subscribe[the mailing list archive] in case someone has
 xref:mailing-list-subscribe[the mailing list archive] in case someone has
 already reported and fixed a similar problem.
 already reported and fixed a similar problem.
 
 
-However you choose to report bugs or get help,
-xref:bugtracker[opening a bug] or
-xref:mailing-list-subscribe[send a mail to the mailing list], there are
+However you choose to report bugs or get help, either by
+xref:bugtracker[opening a bug] or by
+xref:mailing-list-subscribe[sending a mail to the mailing list], there are
 a number of details to provide in order to help people reproduce and
 a number of details to provide in order to help people reproduce and
 find a solution to the issue.
 find a solution to the issue.
 
 
@@ -295,11 +295,16 @@ Here is a short list of details to provide in such case:
 * host machine (OS/release)
 * host machine (OS/release)
 * version of Buildroot
 * version of Buildroot
 * target for which the build fails
 * target for which the build fails
-* package(s) which the build fails
+* package(s) for which the build fails
 * the command that fails and its output
 * the command that fails and its output
 * any information you think that may be relevant
 * any information you think that may be relevant
 
 
-Additionnally, your can add the +.config+ file.
+Additionally, you should add the +.config+ file (or if you know how, a
++defconfig+).
 
 
 If some of these details are too large, do not hesitate to use a
 If some of these details are too large, do not hesitate to use a
-pastebin service (see http://www.similarsitesearch.com/alternatives-to/pastebin.com[]).
+pastebin service. Note that not all available pastebin services will
+preserve Unix-style line terminators when downloading raw pastes.
+Following pastebin services are known to work correctly:
+- https://gist.github.com/
+- http://code.bulix.org/