[OT] Documentation (Was: Re: Foreign Branches)

[Jan Hudec]

On Wed, Oct 26, 2005 at 23:16:07 +0200, Erik Bågfors wrote:
> > Yes, I have noticed it too. Unfortunately it is severely underdocumented. It
> > is mostly focused on the needs of damagecontrol, but that has large common
> > part with what bzr would need. Unfortunately it's in ruby, which itself is
> > severely underdocumented and there does not seem to be an easy reasonable way
> > to mix these two languages, at least until parrot is ready.
> 
> This is somewhat offtopic... but....
> Being a Ruby fan I have to disagree with the fact you are claming that
> Ruby is underdocumented. I have more ruby books than python books at
> home and there are lot's of good resourses online as well....
> 
> In my dream world, bzr is written in ruby (but I don't really mind)

Personally I think Ruby is a better language than Python. I think it's
cleaner design. But the documentation is not good. I don't mean documentation
on the language itself -- I mean documentation on the standard modules. Perl
has good manual pages. Python has docstrings, that can be viewed in the
interactive interpreter. But with Ruby I had problems finding what is
available in the bundled library and how to use it.

Just to clarify, I don't care for paper documentation. Reference manual has
to be online and part of the instalation to be actually useful. And the Ruby
one is not exactly great.

-- 
						 Jan 'Bulb' Hudec <bulb at ucw.cz>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20051027/6e610b9a/attachment.pgp