From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/75416 Path: news.gmane.org!not-for-mail From: asjo@koldfront.dk (Adam =?utf-8?Q?Sj=C3=B8gren?=) Newsgroups: gmane.emacs.gnus.general Subject: Re: Just shoot me now (was Re: What's wrong with this fancy split?) Date: Wed, 22 Dec 2010 19:21:33 +0100 Organization: koldfront - analysis & revolution, Copenhagen, Denmark Message-ID: <87tyi58y8i.fsf@topper.koldfront.dk> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1293042115 31315 80.91.229.12 (22 Dec 2010 18:21:55 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 22 Dec 2010 18:21:55 +0000 (UTC) To: ding@gnus.org Original-X-From: ding-owner+M23768@lists.math.uh.edu Wed Dec 22 19:21:51 2010 Return-path: Envelope-to: ding-account@gmane.org Original-Received: from util0.math.uh.edu ([129.7.128.18]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PVTJu-0004o6-Ky for ding-account@gmane.org; Wed, 22 Dec 2010 19:21:50 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by util0.math.uh.edu with smtp (Exim 4.63) (envelope-from ) id 1PVTJs-0006j0-Qh; Wed, 22 Dec 2010 12:21:48 -0600 Original-Received: from mx2.math.uh.edu ([129.7.128.33]) by util0.math.uh.edu with esmtps (TLSv1:AES256-SHA:256) (Exim 4.63) (envelope-from ) id 1PVTJr-0006ie-7X for ding@lists.math.uh.edu; Wed, 22 Dec 2010 12:21:47 -0600 Original-Received: from quimby.gnus.org ([80.91.231.51]) by mx2.math.uh.edu with esmtp (Exim 4.72) (envelope-from ) id 1PVTJp-00074P-Mu for ding@lists.math.uh.edu; Wed, 22 Dec 2010 12:21:47 -0600 Original-Received: from lo.gmane.org ([80.91.229.12]) by quimby.gnus.org with esmtp (Exim 4.72) (envelope-from ) id 1PVTJp-00074J-0a for ding@gnus.org; Wed, 22 Dec 2010 19:21:45 +0100 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1PVTJo-0004kD-NK for ding@gnus.org; Wed, 22 Dec 2010 19:21:44 +0100 Original-Received: from rain.gmane.org ([80.91.229.7]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 22 Dec 2010 19:21:44 +0100 Original-Received: from asjo by rain.gmane.org with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 22 Dec 2010 19:21:44 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: ding@gnus.org Original-Lines: 38 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: rain.gmane.org Mail-Copies-To: never X-Face: )qY&CseJ?.:=8F#^~GcSA?F=9eu'{KAFfL1C3/A&:nE?PW\i65"ba0NS)97,Q(^@xk}n4Ou rPuR#V8I(J_@~H($[ym:`K_+]*kjvW>xH5jbgLBVFGXY:(#4P>zVBklLbdL&XxL\M)%T}3S/IS9lMJ ^St'=VZBR Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:75416 Archived-At: On Wed, 22 Dec 2010 06:53:07 -0600, Tommy wrote: > So where does that leave us? It is much easier for a developer deep in the code to receive a documentation patch, look at it, and say "Ok, that sounds fine, applied", than it is to receieve a suggestion in words that something - while technically correct - is slightly confusing to a (new) user. (E.g. I agree that not escaping '.' in a regexp matching a domain is confusing to a user who is trying to check his "world-view" by looking at the examples, but it is also plain to see that it isn't wrong - and a user thinking 'regular expressions' will recognize that (but then the clue of "flawless" examples go down the drain)). What I am trying to say is that I think you will find much less argument if you dig out git and start supplying your suggestions for improvements as patches to the manual. It is quite natural to say "Meh, but it isn't wrong" if you're asking someone to do... the horror... work! Appreciating this type of feedback isn't always easy to do cheerfully, sometimes it will be curmudgeonly. > Either the user is thick, or the documentation is thick. Or the user is trying to achieve to many things at once. There is a learning curve, even if you aren't thick ;-) Best regards, Adam -- "Accept the mystery!" Adam Sjøgren asjo@koldfront.dk