Bug 36055

Summary: [PATCH] adding some help-yourself-info to ...best results from FreeBSD-questions...
Product: Documentation Reporter: Martin Karlsson <martin.karlsson>
Component: DocumentationAssignee: Christian Brueffer <brueffer>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Description Flags
file.diff none

Description Martin Karlsson 2002-03-18 18:50:00 UTC
	Currently, the 'How to get the best results from the FreeBSD-questions
	mailing list' article contains no information on what someone could try to do
	to help him/herself, or where to look for info, nor does it contain info on
	the benefits of trying to help oneself before asking -questions.

	The patch I am submitting suggests trying one's manpages, the docs, mailing list archives
	and search engines.

	If anything regarding this PR and the patch is unclear or needs
	discussion, please do not hesitate to contact me.

	Martin Karlsson

How-To-Repeat: 	Read freebsd-questions for a week and see how the same questions seem to reappear, 
	suggesting that posters do not read manpages, documentation, or search mailing 
	list archives before posting their question.
Comment 1 Martin Karlsson 2002-03-19 18:04:38 UTC
* Martin Karlsson <martin.karlsson@visit.se> [2002-03-18 19.43 +0100]:
Well, hopefully my last screw-up for this year (not likely :-)) ...



--- article.old	Tue Mar 19 18:59:09 2002
+++ article.new	Tue Mar 19 18:58:58 2002
@@ -198,6 +198,44 @@
     <title id="submit">How to submit a question</title>
+    <para>Before submitting your question:</para>
+    <itemizedlist>
+      <listitem>
+        <para>Try solving the problem on your own. If you post a question which
+	  shows that you have tried to solve the problem, your question will
+	  generally attract more positive attention from people reading it.
+	  Trying to solve the problem yourself will also enhance your understanding
+	  of FreeBSD, and will eventually let you use your knowledge to help others
+	  by answering questions posted to the mailing lists.
+	</para>
+      </listitem>
+      <listitem>
+        <para>Use the manpages, and the FreeBSD documentation (either installed
+	  in <filename>/usr/doc</filename> or accessible via WWW at <ulink URL="http://www.FreeBSD.org">
+	  http://www.FreeBSD.org</ulink>), especially the <ulink URL="http://www.freebsd.org/handbook/index.html">handbook</ulink>
+	  and the <ulink URL="http://www.freebsd.org/FAQ/index.html">FAQ</ulink>.
+	</para>
+      </listitem>
+      <listitem>
+        <para>Browse and/or search the archives for the mailing list, to see if your
+	  question or a similiar one has been asked (and possibly answered) on the
+	  list. You can browse and/or search the mailing list archives
+	  at <ulink URL="http://www.FreeBSD.org/mail">http://www.FreeBSD.org/mail</ulink>
+	  and <ulink URL="http://www.freebsd.org/search/search.html#mailinglists">http://www.freebsd.org/search/search.html#mailinglists</ulink>
+	  respectively. This can be done at other WWW sites as well, for example
+	  at <ulink URL="http://marc.theaimsgroup.com">http://marc.theaimsgroup.com</ulink>.
+	</para>
+      </listitem>
+      <listitem>
+        <para>Try searching a search engine such as <ulink URL="http://www.google.com">Google</ulink>
+          or <ulink URL="http://www.yahoo.com">Yahoo</ulink>. Google even has
+          a <ulink URL="http://www.google.com/bsd">BSD-specific search interface</ulink>.
+        </para>
+      </listitem>
+    </itemizedlist>
     <para>When submitting a question to FreeBSD-questions, consider the
       following points:</para>
Comment 2 Christian Brueffer freebsd_committer 2003-03-24 13:44:07 UTC
Responsible Changed
From-To: freebsd-doc->brueffer

I'll take this
Comment 3 Christian Brueffer freebsd_committer 2003-04-04 09:27:30 UTC
State Changed
From-To: open->closed

I have committed a slightly modified patch, thanks for the submission!