From martin@foo31-146.visit.se  Mon Mar 18 10:44:14 2002
Return-Path: <martin@foo31-146.visit.se>
Received: from foo31-146.visit.se (foo31-146.visit.se [62.119.31.146])
	by hub.freebsd.org (Postfix) with ESMTP id 7E9CD37B402
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 18 Mar 2002 10:44:13 -0800 (PST)
Received: (from martin@localhost)
	by foo31-146.visit.se (8.11.6/8.11.6) id g2IIhZx02478;
	Mon, 18 Mar 2002 19:43:35 +0100 (CET)
	(envelope-from martin)
Message-Id: <200203181843.g2IIhZx02478@foo31-146.visit.se>
Date: Mon, 18 Mar 2002 19:43:35 +0100 (CET)
From: Martin Karlsson <martin.karlsson@visit.se>
Reply-To: Martin Karlsson <martin.karlsson@visit.se>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] adding some help-yourself-info to ...best results from FreeBSD-questions...
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         36055
>Category:       docs
>Synopsis:       [PATCH] adding some help-yourself-info to ...best results from FreeBSD-questions...
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brueffer
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Mar 18 10:50:00 PST 2002
>Closed-Date:    Fri Apr 04 10:28:18 CEST 2003
>Last-Modified:  Fri Apr 04 10:28:18 CEST 2003
>Originator:     Martin Karlsson
>Release:        FreeBSD 4.5-RELEASE-p2 i386
>Organization:
>Environment:
System: FreeBSD foo31-146.visit.se 4.5-RELEASE-p2 FreeBSD 4.5-RELEASE-p2 #0: Sat Mar 16 23:55:27 CET 2002 root@foo31-146.visit.se:/usr/src/sys/compile/ADAM i386


	
>Description:
	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.

	Regards,
	-- 
	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.
>Fix:

	
*** article_change.sgml	Mon Mar 18 18:33:16 2002
--- article.sgml	Fri Mar 15 09:28:13 2002
***************
*** 197,240 ****
  
    <sect1>
      <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, e.g 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>
  
--- 197,203 ----
  
    <sect1>
      <title id="submit">How to submit a question</title>
!   
      <para>When submitting a question to FreeBSD-questions, consider the
        following points:</para>
  


>Release-Note:
>Audit-Trail:

From: Martin Karlsson <martin.karlsson@visit.se>
To: FreeBSD-gnats-submit@FreeBSD.ORG
Cc:  
Subject: Re: docs/36055: [PATCH] adding some help-yourself-info to ...best results from FreeBSD-questions...
Date: Tue, 19 Mar 2002 19:04:38 +0100

 * Martin Karlsson <martin.karlsson@visit.se> [2002-03-18 19.43 +0100]:
 Well, hopefully my last screw-up for this year (not likely :-)) ...
 
 --
 Martin
 
 
 ---------8<-----------------8<----------------------8<----------------8<---------
 
 
 --- article.old	Tue Mar 19 18:59:09 2002
 +++ article.new	Tue Mar 19 18:58:58 2002
 @@ -198,6 +198,44 @@
    <sect1>
      <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>
 
Responsible-Changed-From-To: freebsd-doc->brueffer 
Responsible-Changed-By: brueffer 
Responsible-Changed-When: Mon Mar 24 14:44:07 CET 2003 
Responsible-Changed-Why:  
I'll take this 

http://www.freebsd.org/cgi/query-pr.cgi?pr=36055 
State-Changed-From-To: open->closed 
State-Changed-By: brueffer 
State-Changed-When: Fri Apr 4 10:27:30 CEST 2003 
State-Changed-Why:  
I have committed a slightly modified patch, thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=36055 
>Unformatted:
