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>

Reply via email to