Date: Fri, 16 Mar 2018 20:36:58 +0000 (UTC) From: Sevan Janiyan <sevan@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51488 - head/en_US.ISO8859-1/articles/contributing Message-ID: <201803162036.w2GKaw2v027655@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@FreeBSDFoundation.org</email>.</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201803162036.w2GKaw2v027655>