From: znmeb@... Date: 2009-02-02T01:42:39+09:00 Subject: [ruby-core:21717] Re: New documentation system! Quoting Austin Ziegler : > On Sun, Feb 1, 2009 at 10:51 AM, Luiz Vitor Martinez Cardoso > wrote: >> What the Ruby community think about developing a better documentation >> system. Something like Python Documentation? > > I'm not familiar with "Python Documentation". What exactly do you mean > by "documentation system" (that is, what do you feel that Ruby > currently offers), and what do you mean by "better" (that is, what do > you feel that Ruby currently lacks). > > -austin > -- > Austin Ziegler * halostatue@gmail.com * http://www.halostatue.ca/ > * austin@halostatue.ca * http://www.halostatue.ca/feed/ > * austin@zieglers.ca > > I'm not familiar with Python documentation either. And I know we've had this discussion before, but I'm a big fan of "literate programming" and "reproducible research." As a "community member", though, I'd expect changes to the "documentation system" to be created the same way everything else here is created -- by patches, discussions on mailing lists and in IRC, test-driven and behavior-driven development, etc. So if the original poster has some ideas, I'd certainly like to see what they are, and how they compare with RDoc / RI. Anybody can start a project on RubyForge or Github, and some projects are appealing enough that developers will gravitate to them. When I run out of other interesting projects, I might revisit the whole "literate programming in Ruby" concept. But the thing is -- what I want to do already exists in the R language because some R community members built it. So there's little incentive for me to actually create something. :) -- M. Edward (Ed) Borasky I've never met a happy clam. In fact, most of them were pretty steamed.