Re: Perl QA website

This is somehow related: Karen pointed out that there is no section on
testing in perlfaq.

There is a "testing" branch now:
https://github.com/perl-doc-cats/perlfaq

On Fri, 6 Feb 2015, Tina MÃŒller wrote:

> Hi,
>
> As I'm getting more familiar with the whole QA infrastructure
> I was looking at http://qa.perl.org/ to check what people
> would see if they used this as a starting point to learn about
> perl module testing.
>
> A few days ago I got a pull request for one of my modules from
> someone new to perl testing.
> He showed what he did:
>    find ./t -maxdepth 1 -type f | while read file; do echo $file; perl -I 
> ./lib $file; done |& less
>
> Of course that does the job but knowing `prove` would have helped ;-)
>
> On qa.perl.org there's lots of information - most is kind of hidden
> in the wiki which you will find behind a small link at the bottom of the
> page. (Honestly, who of you did know that this wiki existed?)
>
> But the last change there was April 2013. And we all know that
> wikis are great for saving informations very fast and easy, but they tend
> to scatter unless you put a lot of work into tidying, categorizing.
>
> Also I think a starting page could give a quick overview of the
> various themes around QA, maybe with a graph.
> Andreas Koenig pointed me to http://www.cpan.org/misc/ZCAN.html where I could
> find a graph from 2002.
>
> Ideally you would go from there to te pages you're searching for.
>
> Examples:
> I'm a new module author - point to basic module setup tutorial (not
> totally QA related)
> I'm a module author and want to start writing tests - point to basic
> testing steps.
> I want to be a CPAN smoker - ...
> I'm just a user of a module and want to know about the infrastructure.
>
> I would be willing to put a little work into this and are happy about
> suggestions and help.
> One question is:
> Should we keep the wiki and tidy it up?
> Or should we rather use github to edit the site?
> https://github.com/perlorg/perlweb/tree/master/docs/qa
> The advantage of a wiki is that anyone can sign up and edit easily.
> It has builtin search functionality.
> On the other hand it's PHP but do we have something similar in Perl?
>
> Also we should ask the wiki hoster/maintainer if we can keep on using it.
>
> Thanks for your time,
> tina
>