On Wednesday 30 Dec 2009 10:50:35 Shlomi Fish wrote: > On Tuesday 29 Dec 2009 23:54:26 Leo Lapworth wrote: > > Hi, > > > > Please note this is cross posted. > > > > Several of the QA people have kindly said they will help with updating > > http://qa.perl.org/. > > > > I'm cross posting to > > http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/perl-org-patches > > > > I've split out the site a bit more, so there is a 'testing your code' and > > a 'testing cpan' section on the site. > > > > So what is needed?... > > > > 1) Testing your code - I think this will need the largest amount of work. > > > > Hilary, could I ask you to have a look at this? > > > > - Are the articles the best we can link to? > > - Do we need those articles if we update the rest of the content. > > - can the test-modules.html and testing-guidelines.html be cleaned up > > and updated > > (currently in POD, but does not have to stay that way)? > > > > 2) Testing CPAN > > > > Shaun, would you mind looking at this? > > > > - Just needs a quick review/update > > > > 3) Phalanx > > > > Shlomi, would you look at this? > > > > - Clean up, so that it can be put aside as completed/superseded. > > OK, I will. >
OK, here goes: 1. "How many tests? How many bugs in RT? Report to Andy." - which Andy is it and where can I find his contact information. 2. Here's a patch that is a minor update (some formatting and some clarifications). Otherwise, the Phalanx site seems good. Regards, Shlomi Fish -- ----------------------------------------------------------------- Shlomi Fish http://www.shlomifish.org/ What does "Zionism" mean? - http://shlom.in/def-zionism Bzr is slower than Subversion in combination with Sourceforge. ( By: http://dazjorz.com/ )
Index: phalanx/kwalitee.html =================================================================== --- phalanx/kwalitee.html (revision 1602) +++ phalanx/kwalitee.html (working copy) @@ -6,23 +6,38 @@ }); %] +<h2>What is Quality?</h2> + +<p> +Software quality is the property of software that makes it fit the needs of +the end-users, not get on their nerves, and make them feel good about using +it. The English Wikipedia has +<a href="http://en.wikipedia.org/wiki/Software_quality">an article about +software quality</a> and Shlomi Fish wrote +<a href="http://www.shlomifish.org/philosophy/computers/high-quality-software/">an essay called "What Makes Software High-Quality?"</a>. +</p> <h2> What is kwalitee? </h2> <p> - Kwalitee is inexact quality. We don't know exactly what it is, but we know it when we see it. +Measuring quality is hard, and so we coined the term Kwalitee which is +measurable (but inexact quality), so we can know it when we see it. </p> <h3> What is a bug? </h3> <p> - If there is any difference between the docs, the code and the tests, it is a bug. Period. The bug might be in the docs or the tests, and the code is fine, but it's still a bug. +If there is any difference between the docs, the code and the tests, it is a +bug. Period. The bug might be in the docs or the tests, and the code is fine, +but it's still a bug. </p> <p> - If there is ambiguity about how the code is supposed to work, it is a bug. The documentation must be clarified, and the code may be out of sync as well. +If there is ambiguity about how the code is supposed to work, it is a bug. The +documentation must be clarified, and the code may be out of sync as well. </p> <p> - If a hoplite discovers something behaving "incorrectly", according to the hoplite, it may or may not be a bug, according to the author's intent. +If a hoplite discovers something behaving "incorrectly", according to the +hoplite, it may or may not be a bug, according to the author's intent. </p> <h3> What's a kwalitee module? Index: phalanx/faq.html =================================================================== --- phalanx/faq.html (revision 1602) +++ phalanx/faq.html (working copy) @@ -14,25 +14,33 @@ How did you come up with the <a href="/phalanx/100/">Phalanx 100</a> list? </h3> <p> - The specifics of how we derived the list isn't really important. We don't want the focus of the project to become which modules are getting attention. We'll be working on a wide variety of CPAN modules, as well as Perl itself, to improve their tests and documentation. +The specifics of how we derived the list isn't really important. We don't want +the focus of the project to become which modules are getting attention. We'll +be working on a wide variety of CPAN modules, as well as Perl itself, to +improve their tests and documentation. </p> <h3> No, but really, did you look at logs or something? </h3> <p> - It really doesn't matter. The list is made and that's what we're going with. We think you'll agree that the 100 modules are a good cross-section of what's popular on the CPAN. Maybe some got missed, maybe some shouldn't be on the list. Still, it's a good start. +It really doesn't matter. The list is made and that's what we're going with. We +think you'll agree that the 100 modules are a good cross-section of what's +popular on the CPAN. Maybe some got missed, maybe some shouldn't be on the +list. Still, it's a good start. </p> <h3> Why 100? </h3> <p> - It's a nice round number that is about 2.5% of CPAN. We figure that the 80/20 rule applies, but in this case, 97.5/2.5 will have to do. +It's a nice round number that used to be about 2.5% of CPAN. We figured +that the 80/20 rule applies, but in this case, 97.5/2.5 will have to do. (Note: +now there are over 17,000 CPAN modules, so it's even less than that.) </p> <h3> So, I bet you got logs from somewhere, right? Did you look at CPANTS? </h3> <p> - OK, ok, we'll tell you! It's a combination of: +OK, ok, we'll tell you! It's a combination of: </p> <ul> <li>Log analysis of search.cpan.org for the last 45 days of 2004 @@ -50,5 +58,6 @@ But Foo::Bar is a LOT more important than DBI! </h3> <p> - That's fine. We can include Foo::Bar in the Phalanx project as well. The list of 100 is just a starting point. +That's fine. We can include Foo::Bar in the Phalanx project as well. The list +of 100 is just a starting point. </p>