[#3109] Is divmod dangerous? — Dave Thomas <Dave@...>

14 messages 2000/06/06

[#3149] Retrieving the hostname and port in net/http — Roland Jesse <jesse@...>

Hi,

12 messages 2000/06/07

[#3222] Ruby coding standard? — Robert Feldt <feldt@...>

16 messages 2000/06/09

[#3277] Re: BUG or something? — Aleksi Niemel<aleksi.niemela@...>

> |I am new to Ruby and this brings up a question I have had

17 messages 2000/06/12
[#3281] Re: BUG or something? — Dave Thomas <Dave@...> 2000/06/12

Aleksi Niemel<aleksi.niemela@cinnober.com> writes:

[#3296] RE: about documentation — Aleksi Niemel<aleksi.niemela@...>

> I want to contribute to the ruby project in my spare time.

15 messages 2000/06/12

[#3407] Waffling between Python and Ruby — "Warren Postma" <embed@...>

I was looking at the Ruby editor/IDE for windows and was disappointed with

19 messages 2000/06/14

[#3410] Exercice: Translate into Ruby :-) — Jilani Khaldi <jilanik@...>

Hi All,

17 messages 2000/06/14

[#3415] Re: Waffling between Python and Ruby — Andrew Hunt <andy@...>

>Static typing..., hmm,...

11 messages 2000/06/14

[#3453] Re: Static Typing( Was: Waffling between Python and Ruby) — Andrew Hunt <andy@...>

32 messages 2000/06/16

[#3516] Deep copy? — Hugh Sasse Staff Elec Eng <hgs@...>

Given that I cannot overload =, how should I go about ensuring a deep

20 messages 2000/06/19

[#3694] Why it's quiet — hal9000@...

We are all busy learning the new language

26 messages 2000/06/29
[#3703] Re: Why it's quiet — "NAKAMURA, Hiroshi" <nahi@...> 2000/06/30

Hi,

[#3705] Re: Why it's quiet — matz@... (Yukihiro Matsumoto) 2000/06/30

Hi,

[ruby-talk:03258] Re: Ruby coding standard?

From: Calvelo Daniel <dcalvelo@...2.fr>
Date: 2000-06-10 20:13:24 UTC
List: ruby-talk #3258
Mathieu Bouchard <matju@cam.org> wrote:

: About what the code should do and how it does it:

:   * the code shows "HOW", the comment shows "WHAT"

: or, if you can:

:   * the code shows "WHAT" so you don't need a comment telling "WHAT".

: a supplementary comment, "WHY", might be desirable. This is usually left
: out, but in many circumstances it would be helpful, if only to prevent a
: random programmer from rewriting your code while thinking you are an
: idiot. 

Hi,

I mostly agree with those three ways of reading code. I have some
Python, and would like to ask for one of its best features: docstrings. 
I don't know where the idea comes from; it is available in Matlab/
Octave, in some flavours of lisp, and where else? 

The HOW should be obvious from code, except for tricks and delicate things
which I tend to comment. (I would fall in love with an editor that allowed
me to put diagrams into my code. I have to do that one day. ) There is one
thing that is extremely useful: the function signature. Most of the WHAT
is there, or IMHO should be.

Now, if we had the WHAT/WHY part available for interactive ruby... 

lacking-superlatives-ly y'rs

DCA

-- Daniel Calvelo Aros
     calvelo@lifl.fr

In This Thread