[#7055] More on VC++ 2005 — Austin Ziegler <halostatue@...>

Okay. I've got Ruby compiling. I'm attempting to get everything in

17 messages 2006/01/05
[#7058] Re: More on VC++ 2005 — nobuyoshi nakada <nobuyoshi.nakada@...> 2006/01/06

Hi,

[#7084] mathn: ugly warnings — hadmut@... (Hadmut Danisch)

Hi,

22 messages 2006/01/10
[#7097] Re: mathn: ugly warnings — Daniel Berger <Daniel.Berger@...> 2006/01/10

Hadmut Danisch wrote:

[#7098] Design contracts and refactoring (was Re: mathn: ugly warnings) — mathew <meta@...> 2006/01/10

Daniel Berger wrote:

[#7118] Re: Design contracts and refactoring (was Re: mathn: ugly warnings) — mathew <meta@...> 2006/01/12

*Dean Wampler *<deanwampler gmail.com> writes:

[#7226] Fwd: Re: Question about massive API changes — "Sean E. Russell" <ser@...>

Hello,

23 messages 2006/01/28
[#7228] Re: Question about massive API changes — Caleb Tennis <caleb@...> 2006/01/28

>

Re: Design contracts and refactoring (was Re: mathn: ugly warnings)

From: ara.t.howard@...
Date: 2006-01-12 20:30:26 UTC
List: ruby-core #7124
On Fri, 13 Jan 2006, Mathieu Bouchard wrote:

> I've thought of a triad:
>
>  A. "the real thing"
>  B. what it's documented as
>  C. a way to verify that (1) and (2) agree

i did something recently that addresses this in a way:

first of all, included no docs - only tests and a samples/ dir.  the samples
dir has very simple programs in it like a.rb, b.rb, etc.  every sample program
outputs yaml, which is quite nice to read.  in addition, i store the expected
output of each sample program in sample/expected/a.rb.  now it's quite simple
for my unit tests to also check that every sample program runs and creates the
correct output.

admittedly this is only a step up from saying 'read the unit test', but the
higher level and shortness of sample programs does make it a step up.  also,
the sample programs can progress in complexity in such a way to teach the user
in a nice way.

-a
-- 
strong and healthy, who thinks of sickness until it strikes like lightning?
preoccupied with the world, who thinks of death, until it arrives like
thunder?  -- milarepa


In This Thread