[#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 21:07:15 UTC
List: ruby-core #7126
On Fri, 13 Jan 2006, James Britt wrote:

> ara.t.howard@noaa.gov wrote:
> ...
>
>> 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.
>
> But what will the user see from ri and rdoc?

nothing.  i've found myself using them less and less - at this point i use
them about once per month.  my feeling is that

   vi -o samples/*

is much more powerful.

when considering all the libraries i've released i get the fewest question and
most bug fixes not from the documented ones - but the the ones with the most
samples.

i realize my view will be in the minority and that some projects simple cannot
fit into this box.  in any case, it's my person opinion that testable samples
are a huge benefit to library maintainers and users and that, except for very
large and complex systems, really do serve quite well as documentation.

my intent in posting this, btw, was just to bring attention to the fact that
i've found it useful and people who love docs and unit tests might consider it
as another weapon.

cheers.

-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