Giles nails it on the head:

Ruby: Public/Private Distinction Belongs In Comments, Not Code

gilesbowkett.blogspot.com 04 Mar '12, 11pm

Giles nails it on the head:

with Loren Segal. Realized why I was right when I revisited TomDoc and took a look at how it handles the public/private distinction. # Public: Duplicate some text an arbitrary number of times. # # text - The String to be duplicated. # count - The Integer number of times to duplicate the text. # # Examples # # multiplex('Tom', 4) # # => 'TomTomTomTom' # # Returns the duplicated String. def multiplex(text, count) text * count end I'm not out to put words into the mouth of TomDoc's author -- he might disagree -- but I believe TomDoc gets it exactly right, putting that distinction into comments. I firmly believe putting that distinction anywhere except comments is rude and disrespectful to your fellow developers. It goes in the comments because it's opinion . First, anyone who's done non-trivial stuff with Rails has seen "private" APIs turn effectively public, even if only for...

Full article: http://gilesbowkett.blogspot.com/2012/03/ruby-publicpriva...

Tweets

@JayRWren » 27 Mar '12, 2pm
@peterc i'm sorry for being thick but I see nothing. can you link me? I'm looking here: [link]
@tdreyno » 08 Mar '12, 7pm
@akahn I agree with this: [link]
@masihjesus » 06 Mar '12, 7pm
public/prviate distinction in Ruby should only appear in comments --> [link] [something to think about]
@joshsusser » 05 Mar '12, 7pm
Oh look, @gilesgoatboy says something totally right while not ranting. I agree, "private" is a non-feature in Ruby. [link]
@stevie_chambers » 05 Mar '12, 12pm
this is why #ruby is different: [link] by @gilesgoatboy
@centipedefarmer » 05 Mar '12, 12am
RT @steveklabnik: Giles nails it on the head: [link]
@iain_nl » 05 Mar '12, 12am
Good article by @gilesgoatboy: Public/private distinction belongs in comments, not code [link]
@steveklabnik » 04 Mar '12, 11pm
Giles nails it on the head: [link]
@gilesgoatboy » 04 Mar '12, 11pm
@lsegal yeah [link] etc etc. rough draft called you a Satan worshipper, but figured that was going too far.
@hazula » 05 Mar '12, 1am
RT @steveklabnik: Giles nails it on the head: [link]

Ruby: Public/Private Distinction Belongs In Comments, Not Code

Giles nails it on the head:

Tweets

method_profiler: Find slow methods in your Ruby...

21 Ruby Tricks You Should Be Using In Your Own ...

Learn Morse code to help disaster victims, radi...

writing readable ruby

ActiveWarehouse (Ruby ETL) v1.0.0.rc1 is out

13 dead, 50 injured in Polish head-on train crash

why’s (poignant) guide to ruby :: 4. Floating L...

Class and Instance Variables In Ruby // RailsTi...

Ruby on REST 4: Using Representers in Rails: Th...