From docs-return-10644-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org Thu May 3 16:20:58 2012 Return-Path: X-Original-To: apmail-httpd-docs-archive@www.apache.org Delivered-To: apmail-httpd-docs-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id B38659C66 for ; Thu, 3 May 2012 16:20:58 +0000 (UTC) Received: (qmail 9757 invoked by uid 500); 3 May 2012 16:20:58 -0000 Delivered-To: apmail-httpd-docs-archive@httpd.apache.org Received: (qmail 9643 invoked by uid 500); 3 May 2012 16:20:58 -0000 Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: docs@httpd.apache.org List-Id: Delivered-To: mailing list docs@httpd.apache.org Received: (qmail 9634 invoked by uid 99); 3 May 2012 16:20:58 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 03 May 2012 16:20:58 +0000 X-ASF-Spam-Status: No, hits=2.2 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_NEUTRAL X-Spam-Check-By: apache.org Received-SPF: neutral (nike.apache.org: local policy) Received: from [209.85.213.173] (HELO mail-yx0-f173.google.com) (209.85.213.173) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 03 May 2012 16:20:50 +0000 Received: by yenr5 with SMTP id r5so2588716yen.18 for ; Thu, 03 May 2012 09:20:29 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=from:mime-version:content-type:subject:date:in-reply-to:to :references:message-id:x-mailer:x-gm-message-state; bh=2nA0fsQO2Z2TWIuT5+WxLalTBJONO09NEMH7BvscPeM=; b=eQDpSa3VKSyqJGATpuCiSMx9j4161XOb8HqZeO2qO6TW7m/4+SrkFgn6wS9/qjYwHv a7Ei7/I6U6mhKw7Hv3SyL95G2KXBXO1xrAB9qjOsS8HZF1y4skdP27Ns2z6HOT/T3y7z 5yOtcp+aDIxhNnfFlcG1296mpaFlWLfKyuIp1wWgakGTNsFj+I2IG36NpYoSFnr3WyAz GIGaOqZIUxgNrt0MLXN4hdoWx8hRF1AUmTlZIpJd611lAR8D8iaCEmILThiBOWjmaq6p dV8e9Pngx3Jq4eRTa6arDz/gHjkVVlzOb6Y92tIrKxSONJzU8alXcplvQRQ9yk9Ne6bu b/cg== Received: by 10.50.45.234 with SMTP id q10mr1087646igm.54.1336062028921; Thu, 03 May 2012 09:20:28 -0700 (PDT) Received: from [192.168.0.198] (74-131-224-250.dhcp.insightbb.com. [74.131.224.250]) by mx.google.com with ESMTPS id p5sm239500igl.2.2012.05.03.09.20.26 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 03 May 2012 09:20:27 -0700 (PDT) From: Rich Bowen Mime-Version: 1.0 (Apple Message framework v1257) Content-Type: multipart/alternative; boundary="Apple-Mail=_55D8BDEF-D586-4FC8-BFB9-EA51B3070DE3" Subject: Re: Comments in docs Date: Thu, 3 May 2012 12:20:25 -0400 In-Reply-To: <2184282F-AC40-4A1F-BEA3-CA7568FBBD77@apache.org> To: docs@httpd.apache.org References: <66CBEEE9-9F7A-4B57-B218-EE68F01725A0@rcbowen.com> <2184282F-AC40-4A1F-BEA3-CA7568FBBD77@apache.org> Message-Id: <6C19947A-0A9C-468E-9433-BE89FC4A114F@rcbowen.com> X-Mailer: Apple Mail (2.1257) X-Gm-Message-State: ALoCoQmLdguHmuebDmBgKiEoUZ/8VoUkkzJg6/FARlms245afDc0WdteQk19lidpvvPGu8lEM/zl --Apple-Mail=_55D8BDEF-D586-4FC8-BFB9-EA51B3070DE3 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=us-ascii On May 3, 2012, at 12:08 PM, Nick Kew wrote: >>=20 >> I've long been a fan of the PHP documentation - specifically, the way = that they solicit commentary from readers, and then fold that commentary = into the docs. Not only did it encourage me to comment on the docs, it = also got me involved in the PHP documentation project, at least = marginally. The barrier to entry is so low that all you have to do is be = a writer. >=20 > I introduced a comment mechanism at apachetutor, only to find a = predominance of spam over > anything worth having (a very occasional worthwhile comment or = question that provoked me > to update something). There's also an annoying-spam issue on our = httpd wiki. >=20 > How does PHP documentation deal with the problem of spam? I've noticed *very* little spam in the php docs. They have an "are you a = human" type of math word problem that you have to answer. Like "What is = five minus one". But they also moderate the comments as they come in, = which is a thankless job. I think that it's worthwhile, but will require = some folks volunteering to staff this. I volunteer. -- Rich Bowen rbowen@rcbowen.com :: @rbowen rbowen@apache.org --Apple-Mail=_55D8BDEF-D586-4FC8-BFB9-EA51B3070DE3 Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=us-ascii

I've long been a = fan of the PHP documentation - specifically, the way that they solicit = commentary from readers, and then fold that commentary into the docs. = Not only did it encourage me to comment on the docs, it also got me = involved in the PHP documentation project, at least marginally. The = barrier to entry is so low that all you have to do is be a = writer.

I introduced a comment mechanism at = apachetutor, only to find a predominance of spam over
anything worth = having (a very occasional worthwhile comment or question that provoked = me
to update something).  There's also an annoying-spam issue on = our httpd wiki.

How does PHP documentation deal with the problem = of spam?

I've noticed *very* little = spam in the php docs. They have an "are you a human" type of math word = problem that you have to answer. Like "What is five minus one". But they = also moderate the comments as they come in, which is a thankless job. I = think that it's worthwhile, but will require some folks volunteering to = staff this. I volunteer.

--
Rich Bowen
rbowen@rcbowen.com :: = @rbowen
rbowen@apache.org





= --Apple-Mail=_55D8BDEF-D586-4FC8-BFB9-EA51B3070DE3--