[#394281] Can someone throw me a bone — Bob Baird <lists@...>

Hi all,

14 messages 2012/04/02

[#394311] using hash as database? Secure databases with ruby? — ruby rocks <lists@...>

I am new to programming and am learning ruby as my first language. I

16 messages 2012/04/03
[#394315] Re: using hash as database? Secure databases with ruby? — Hassan Schroeder <hassan.schroeder@...> 2012/04/03

On Tue, Apr 3, 2012 at 10:30 AM, ruby rocks <lists@ruby-forum.com> wrote:

[#394318] Re: using hash as database? Secure databases with ruby? — ruby rocks <lists@...> 2012/04/03

Hassan Schroeder wrote in post #1054862:

[#394320] Re: using hash as database? Secure databases with ruby? — Florian Gilcher <flo@...> 2012/04/03

[#394375] Call for comments - Structure — Hal Fulton <rubyhacker@...>

Greetings, fellow Rubyists...

14 messages 2012/04/04

[#394390] Design pattern question — James French <James.French@...>

Hi group,

15 messages 2012/04/05

[#394471] How to pull out specific part of a variable and set to another variable? — "Charlie B." <lists@...>

I have a variable that is a long string. The variable looks like this:

9 messages 2012/04/09

[#394492] New to Ruby, tutorial gives wrong example. — Roger McDonald <lists@...>

I am just starting with Ruby with intention to learn and perhaps use it

11 messages 2012/04/10

[#394533] A Beginner's Question about Metaprogramming — Phil Stone <lists@...>

Hey guys, have a question about Ruby programming and found this forum

20 messages 2012/04/10

[#394616] How to test if array element exists? — Soul Surf <lists@...>

I'm new to Ruby and just want to test if an array element exists. Here's

11 messages 2012/04/13

[#394642] how to avoid escaping special chars after backslah in string — Lucky Nl <lists@...>

Hi friends,

13 messages 2012/04/13
[#394645] Re: how to avoid escaping special chars after backslah in string — Roger Pack <lists@...> 2012/04/13

so what's your ideal syntax here?

[#394658] Why doesn't Fixnum#to_d exist? — Mark Campbell <nitrodist@...>

http://stdlib.rubyonrails.org/libdoc/bigdecimal/rdoc/index.html

15 messages 2012/04/13
[#394660] Re: Why doesn't Fixnum#to_d exist? — Bartosz Dziewoński <matma.rex@...> 2012/04/13

It does exist, but it's in a separate file - bigdecimal/util or utils,

[#394663] Re: Why doesn't Fixnum#to_d exist? — Mark Campbell <nitrodist@...> 2012/04/13

Yes, that file has the String#to_d, Float#to_d and Rational#to_d.

[#394675] Operator overloading of the subscript operator — Ralph Shnelvar <ralphs@...32.com>

I understand that operators (e.g. +, -, *, []) are nothing more than method names so that

16 messages 2012/04/14
[#394677] Re: Operator overloading of the subscript operator — "Jan E." <lists@...> 2012/04/14

Hi,

[#394678] Re: Operator overloading of the subscript operator — Ralph Shnelvar <ralphs@...32.com> 2012/04/14

Jan,

[#394767] Capital Cyrillic letter in Ruby class name (UTF-8) — Vladimir Kerimov <lists@...>

Hi matz,

22 messages 2012/04/17

[#394803] Why must I know whether I extend a class or a module? — Marc Heiler <lists@...>

Hi.

18 messages 2012/04/18
[#394843] Re: Why must I know whether I extend a class or a module? — Intransition <transfire@...> 2012/04/19

On Wednesday, April 18, 2012 1:13:17 PM UTC-4, Marc Heiler wrote:

[#394853] How can i make the colorful font with black background for puts? — gmspro gmspro <lists@...>

puts 'Hello World."

10 messages 2012/04/19

[#394865] finding duplicates in an array and its index number — newto ruby <lists@...>

Hi,

11 messages 2012/04/19

[#394964] To developers of Ruby: Feeble documentation - weakness of Ruby and the Ruby on Rails (2nd edition) — Sergey Ezhov <lists@...>

Directly I apologize for my English - I used the automatic translator.

13 messages 2012/04/23
[#394971] Re: To developers of Ruby: Feeble documentation - weakness of Ruby and the Ruby on Rails (2nd editio — Brian Candler <lists@...> 2012/04/23

I think you are a bit confused.

[#394969] gem-packed script with DATA section does not work — Wybo Dekker <wybo@...4all.nl>

The attached minimal gem contains a script that reads "Hello World!"

20 messages 2012/04/23
[#394970] Re: gem-packed script with DATA section does not work — Xavier Noria <fxn@...> 2012/04/23

DATA points to the contents after the __END__ directive of the executable

[#394973] Re: gem-packed script with DATA section does not work — Wybo Dekker <wybo@...4all.nl> 2012/04/23

On 2012-04-23 11:39, Xavier Noria wrote:

[#394988] Re: gem-packed script with DATA section does not work — Ryan Davis <ryand-ruby@...> 2012/04/23

[#394997] Re: gem-packed script with DATA section does not work — Peter Zotov <whitequark@...> 2012/04/23

Ryan Davis писал 23.04.2012 22:58:

[#395004] Re: gem-packed script with DATA section does not work — Wybo Dekker <wybo@...4all.nl> 2012/04/24

On 2012-04-23 22:57, Peter Zotov wrote:

[#395024] -BEGINNERS- Where do I Start? — "Thought M." <lists@...>

Hello World....... I am very new to code but have been glancing at it

13 messages 2012/04/25

[#395035] if if if statment — fox foxmaster <lists@...>

Hi all,

19 messages 2012/04/25

[#395085] Wrappng up my Text Game! Need Help! — Jared Hobbs <lists@...>

Hi, everyone. This is my first post!

18 messages 2012/04/26

[#395099] ruby/shoes GUI - sqlite, how to isert a variable key in table? — "Danilo L." <lists@...>

Hello, I am struggling to insert a variable into a table, for example:

17 messages 2012/04/27
[#395104] Re: ruby/shoes GUI - sqlite, how to isert a variable key in table? — Zachary Scott <zachary@...> 2012/04/27

Hi Danilo, How are you enjoying shoooes?

[#395105] Re: ruby/shoes GUI - sqlite, how to isert a variable key in table? — Michel <michel.revesche@...> 2012/04/27

[#395113] why does this return 255 bits instead of 256 (and general bit byte hex string array crypt mayhem :P) — instance_variable ok <lists@...>

So I am doing something that requires me to manipulate things on the bit

14 messages 2012/04/27

[#395193] delete character from array — Ok Ok <lists@...>

Here is my question...

17 messages 2012/04/30
[#395196] Re: delete character from array — Ok Ok <lists@...> 2012/04/30

Yes that was exactly it. I have one more question maybe you can help me

Feeble documentation - weakness of Ruby and the Ruby on Rails

From: Sergey Ezhov <lists@...>
Date: 2012-04-22 13:47:25 UTC
List: ruby-talk #394957
Directly I apologize for my English - I used the automatic translator.
If there is a possibility,
find the person, knowing Russian better, it will translate you correctly
the text.

Address to developers of Ruby and Ruby on Rails:

Hi

It would be desirable to express the subjective judgement on a problem
of popularity of Ruby
and the Ruby on Rails in particular. It is very beautiful and laconic
language, very powerful language.
I studied it according to the book, it was necessary to read 2 times up
to the end to understand all
details. And I not for nothing spent the time. It is very powerful tool
for development. The same it
is possible to tell and about the Ruby on Rails. Agree that it not the
simplest systems that here so
from the first everything to understand. I am the professional
programmer with more than
20-year experience, studied many systems and programming languages -
Pascal, C, C ++, Java, Prolog,
Delphi, PHP, developed different systems. Don't think that I am a school
student any. Knowing all this
languages, I after all delighted with Ruby!

And here, by the way, about PHP. I learned it an ex-remental way, with
site use www.php.org. Here in
than all charm of this site - there is ALL and directly! There is as the
language syntax description,
and the description of all functions in case of what if it is function,
that is links to the similar
functions accompanying. Everything is easy and simple - the person
gradually learns more and more,
plunges into this environment more and more development. Any puzzles and
guesses. For me the study of
PHP was simple and fast.

And so I have a question. Why, possessing, so powerful possibilities of
Ruby and the Ruby on Rails
still possess such feeble documentation? After all this most important
in popularity of ANY system -
existence of good documentation when to the person always is where to
address for the sparvochny
information instead of to build own guesses, not to rummage in source
codes. To rummage in source
codes is programming for the sake of programming, and after all people
simply want to use the tool.
To receive quickly necessary information on system is already a success
half, I read. Not enough
description of functions, is necessary still that the person could see
similar functions that could
follow as on a chain. You look on documentation on the same www.php.org
also look at Ruby and
Ruby on Rails documentation. In yours documentation
(http://www.ruby-doc.org/core-1.9.3/), for
example, I couldn't find the description of method_missing, but in other
source (http://apidock.com/)
it is. Unless it is impossible to create a normal site with
documentation where there would be all
and directly? Why the person shall guess, rummage about something in
source codes? About Ruby on Rails
documentation (http://api.rubyonrails.org/) I generally am silent -
there is no description many
methods if there is a description, not clearly what it can accept
parameters and that they mean,
there is no description of classes, their correlations.

You developed such fine system, a magnificent programming language,
excellent framework, so why you
can't develop normal, distinct documentation? In it popularity of PHP
and weakness of Ruby, only in it.
There would be same good documentation, then long ago Ruby would walk
ahead Planet (Earth) at all -
("To be number one"). It seems to me davny already it is time to supply
design team with design team
DOCUMENTATION. After all the maturity of any product is characterized
just by convenient and extensive
documentation, including.

I think that many are stopped just by this moment in study when people
face that simply can't move
easily further in study and use of these systems - Ruby and the Ruby on
Rails.

And once again thanks for so excellent tools!

Yours faithfully, Sergey

===


Обращение к разработчикам Ruby и Ruby on Rails:

Здравствуйте

Хочется высказать свое субъективное мнение на проблему популярности Ruby
и Ruby on Rails в частности.
Это очень красивый и лаконичный язык, очень мощный язык. Я его изучил по
книге, пришлось прочитать
2 раза, чтобы до конца уяснить все детали. И я не зря потратил свое
время. Это очень мощный инструмент
для разработки. То же самое можно сказать и про Ruby on Rails.
Согласитесь, что это не самые простые
системы, чтобы вот так с первого раза все понять. Я профессиональный
программист с более чем
20-летним опытом работы, изучил немало систем и языков программирования
- Pascal, C, C++, Java, Prolog,
Delphi, PHP, разрабатывал различные системы. Не думайте, что я школьник
какой-нибудь. Зная все эти
языки, я все-таки в восторге от Ruby!

И вот, кстати, о PHP. Его я выучил эксперементальным путем, с
использованием сайта www.php.org. Вот в
чем вся прелесть этого сайта - там есть ВСЕ и сразу! Там есть как
описание синтаксиса языка, так и
описание всех функций, при чем если это функция, то есть ссылки на
похожие функции, сопутствующие.
Все легко и просто - человек постепенно все больше и больше узнает, все
больше погружается в эту среду
разработки. Никаких головоломок и догадок. Для меня изучение PHP было
простым и быстрым.

Так вот у меня вопрос. Почему, обладая, столь мощными возможностями Ruby
и Ruby on Rails до сих пор
обладают такой слабой документацией? Ведь это самое главное в
популярности ЛЮБОЙ системы -
наличие ХОРОШЕЙ документации, когда человеку всегда есть куда обратиться
за спарвочной
информацией, а не строить собственные догадки, не рыться в исходниках.
Рыться в исходниках - это
программирование ради программирования, а ведь люди просто хотят
использовать инструмент. Получить
быстро нужную информацию о системе - это уже половина успеха, я считаю.
Мало описания функций, надо
еще чтобы человек мог видеть похожие функции, чтобы мог следовать как по
цепочке. Вы посмотрите
на документацию на том же www.php.org и посмотрите на документацию Ruby
и Ruby on Rails. В вашей
документации (http://www.ruby-doc.org/core-1.9.3/), например, я не смог
найти описание method_missing,
зато в другом источнике (http://apidock.com/) оно есть. Разве нельзя
создать нормальный сайт с
документацией, где было бы все и сразу? Почему человек должен о чем-то
догадываться, рыться в
исходниках? Про документацию Ruby on Rails (http://api.rubyonrails.org/)
я вообще молчу - нет описания
многих методов, если есть описание, то не понятно какие он может
принимать параметры и что они
означают, нет описания классов, их взаимосвязей.

Вы разработали такую прекрасную систему, великолепный язык
программирования, превосходный
фреймворк, так почему вы не можете разработать нормальную, внятную
документацию? В этом
популярность PHP и слабость Ruby, только в этом. Была бы такая же
хорошая документация, тогда давно
бы Ruby шагал впереди планеты всей. Мне кажется давное уже пора снабдить
команду разработчиков
командой разработчиков ДОКУМЕНТАЦИИ. Ведь зрелость любого продукта
характеризуется как раз
удобной и обширной документацией, в том числе.

Я думаю, что многих останавливает как раз этот момент в изучении, когда
люди сталкиваются с тем, что
просто не могут легко двигаться дальше в изучении и использовании этих
систем - Ruby и Ruby on Rails.

И еще раз спасибо за столь превосходные инструменты!

С Уважением, Сергей

---

-- 
Posted via http://www.ruby-forum.com/.

In This Thread

Prev Next