Mailing-List: contact cloudstack-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: cloudstack-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of radhika.puthiyetath@citrix.com
 designates 203.166.19.134 as permitted sender)
From: Radhika Puthiyetath <radhika.puthiyetath@citrix.com>
To: "cloudstack-dev@incubator.apache.org"
	<cloudstack-dev@incubator.apache.org>
CC: Jessica Tomechak <Jessica.Tomechak@citrix.com>
Date: Tue, 13 Nov 2012 09:41:24 +0530
Subject: RE: [Discuss] User Comment Functionality for the ASFCS Doc Pages
Thread-Topic: [Discuss] User Comment Functionality for the ASFCS Doc Pages
Thread-Index: Ac3A+o7oASzyahyrRQWYQdN0w5iGDgAWE4Cg
Message-ID: 
 <97F4356AEA71904482CD192135C038F90113046EDE25@BANPMAILBOX01.citrite.net>
References: 
 <97F4356AEA71904482CD192135C038F90113046EDDFF@BANPMAILBOX01.citrite.net>
 <1352741029.28690.140661152681001.4E22DA32@webmail.messagingengine.com>
In-Reply-To: 
 <1352741029.28690.140661152681001.4E22DA32@webmail.messagingengine.com>
Accept-Language: en-US
Content-Language: en-US
acceptlanguage: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

Hi,

Improving documentation is always our priority. What I am suggesting is a "=
nice-to-have" feature in the future.=20

This was one of the earlier items that the doc team charted along with othe=
r things, such as auto-build.=20

The comments are usually monitored and responded by the doc team itself.  W=
e can definitely do some R&D around Publican to devise such a mechanism.

I felt receiving comments from readers is as important as getting the numbe=
r of random visits.

Jessica, please share your suggestions as well.

Thanks
-Radhika


-----Original Message-----
From: Joe Brockmeier [mailto:jzb@zonker.net]=20
Sent: Monday, November 12, 2012 10:54 PM
To: cloudstack-dev@incubator.apache.org
Subject: Re: [Discuss] User Comment Functionality for the ASFCS Doc Pages

On Mon, Nov 12, 2012, at 11:09 AM, Radhika Puthiyetath wrote:
> Hi Community,
>=20
> Analytics discussion reminded me of this functionality of most product=20
> documentation pages: Leave a Comment/ User comments.
>=20
> Could we integrate "Leave a Comment" functionality to the Apache=20
> CloudStack Documentation pages?

The questions that come to mind immediately:

- Technically, how would you accomplish this? We use Apache CMS for the sit=
e - it does not have commenting functionality. The docs are published with =
Publican, which doesn't provide any commenting functionality.=20

Now - it's not impossible, but it's a feature that seems less important to =
me than working to improve the state of the docs in general. (Which still n=
eed work.)=20

- Who's going to monitor, and respond to, the comments? Who's going to mana=
ge spam filtering?=20

Best,=20

Joe
--
Joe Brockmeier
jzb@zonker.net
Twitter: @jzb
http://www.dissociatedpress.net/