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>
