svn commit: r51488 - head/en_US.ISO8859-1/articles/contributing

[Sevan Janiyan]

Author: sevan
Date: Fri Mar 16 20:36:57 2018
New Revision: 51488
URL: https://svnweb.freebsd.org/changeset/doc/51488

Log:
  Improve wording.
  
  PR:		212992
  Submitted by:	<duncam2 AT rpi Dot edu>
  Approved by:	bcr (mentor)
  Differential Revision:	https://reviews.freebsd.org/D12075

Modified:
  head/en_US.ISO8859-1/articles/contributing/article.xml

Modified: head/en_US.ISO8859-1/articles/contributing/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/contributing/article.xml	Fri Mar 16 17:48:35 2018	(r51487)
+++ head/en_US.ISO8859-1/articles/contributing/article.xml	Fri Mar 16 20:36:57 2018	(r51488)
@@ -82,8 +82,8 @@
       <orderedlist>
 	<listitem>
 	  <para>Read through the FAQ and Handbook periodically.  If
-	    anything is badly explained, out of date or even just
-	    completely wrong, let us know.  Even better, send us a fix
+	    anything is poorly explained, ambiguous, out of date or
+            incorrect, let us know.  Even better, send us a fix
 	    (Docbook is not difficult to learn, but there is no
 	    objection to ASCII submissions).</para>
 	</listitem>
@@ -92,8 +92,9 @@
 	  <para>Help translate FreeBSD documentation into your native
 	    language.  If documentation already exists for your
 	    language, you can help translate additional documents or
-	    verify that the translations are up-to-date.  First take a
-	    look at the <link xlink:href="&url.books.fdp-primer;/translations.html">Translations
+	    verify that the translations are up-to-date and correct.
+	    First take a look at the <link
+	      xlink:href="&url.books.fdp-primer;/translations.html">Translations
 	      FAQ</link> in the FreeBSD Documentation Project Primer.
 	    You are not committing yourself to translating every
 	    single FreeBSD document by doing this — as a
@@ -109,8 +110,8 @@
 	    even regularly).  It can be very satisfying to share your
 	    expertise and help people solve their problems; sometimes
 	    you may even learn something new yourself!  These forums
-	    can also be a source of ideas for things to work
-	    on.</para>
+	    can also be a source of ideas for things to improve upon.
+          </para>
 	</listitem>
       </orderedlist>
     </sect2>
@@ -118,8 +119,8 @@
     <sect2 xml:id="ongoing-programmer-tasks">
       <title>Ongoing Programmer Tasks</title>
 
-      <para>Most of the tasks listed here require either a
-	considerable investment of time, or an in-depth knowledge of
+      <para>Most of the tasks listed here may require a
+	considerable investment of time, an in-depth knowledge of
 	the FreeBSD kernel, or both.  However, there are also many
 	useful tasks which are suitable for
 	<quote>weekend hackers</quote>.</para>
@@ -135,7 +136,7 @@
 	</listitem>
 
 	<listitem>
-	  <para>Read the &a.bugs;.  There might be a problem you can
+	  <para>Read the &a.bugs;.  There may be a problem you can
 	    comment constructively on or with patches you can test.
 	    Or you could even try to fix one of the problems
 	    yourself.</para>
@@ -470,7 +471,8 @@
 	    site</link>.</para>
 
 	<para>More information about the FreeBSD Foundation can be
-	  found in <link xlink:href="https://people.FreeBSD.org/~jdp/foundation/announcement.html">The
+	  found in <link 
+	    xlink:href="https://people.FreeBSD.org/~jdp/foundation/announcement.html">The
 	    FreeBSD Foundation -- an Introduction</link>.  To contact
 	  the Foundation by email, write to
 	  <email>bod at FreeBSDFoundation.org</email>.</para>