Eric Wilhelm wrote:
# from David Golden
# on Wednesday 10 September 2008 04:07:
I would suggest just including a link to the wiki.
It has information on how to get set up to send tests and they can get
to the reports page from there. Having a choice of two websites
decreases the chance they'll look at either. (Economists have
determined that choice is stressful.)
Ok, let's get stressed-out then... http://wiki.cpantesters.org/
choice 1: "Home" - takes me to where I already am!
2: "RecentChanges" - huh?
3: "Sign up or login" - maybe that's what I should do?
4: "history" - NotSoRecentChanges?
5: Search - try "install" ;-)
... Lots of text ...
9: Mail barbie - maybe I should try that?
10: Prologue
11: Why Is Testing Important?
...
16: GettingStarted - hmm... I need a cluster?
...
18: CPAN-Reporter Installation
Now I can see why some threads on this list go on for ages ;-)
This was a bit more than I anticipated. I appreciate cpan testers work
and want to support the effort. I have had in the last few weeks put up
test releases of modules which have failed for geniune reasons, have
taken note of these failures and addressed them. I'd like to encourage
people to submit test reports. I didn't think this was such a bad thing.
I'm not responsible for the cpan testers wiki.
And so on ;-) The wiki is a bit noisy as quick intros go. Especially
if this is an interruption to "I was about to install this module", so
we're quickly hitting the "no, that's a big distraction" threshold.
I've put this in the pod so you will only see it if you look at the pod
on cpan first or after installing the module.
It is not an interruption in the install process since I've not added a
note during the install. I was hoping it would encourage more people to
install CPAN::Reporter - thats all.
And on the subject of interruption... this is part of your module
documentation (I hope it's toward the end), so keep it short and sweet?
It is towards the end - see comments above.
"
=head2 CPAN Testers Reporting
Please install CPAN::Reporter so that a report of the installation and
test results can be seen by the author and other users. Please see
L<http://wiki.cpantesters.org/wiki/QuickStart> for instructions and
more information.
"
I have no objection to reducing the number of links to 1 or making the 1
link the quickstart guide.
Or so? Then just have the QuickStart page *start* with the two most
common setups, followed by the "oh this is neat, tell me more" links.
And, why is 'o conf init test_report' needed if I'm just going to take
the defaults?
good point - adjustment made.
That's just my "being the user" assessment. You could try interrupting
an impatient co-worker and see what they think ;-)
--Eric
Thanks to all that commented.
Martin
