Ruby documentation

Oops, I gotta update that statement; there's been a few other
contributors in the last, oh... year? :slight_smile:

Gavin

···

On Saturday, December 4, 2004, 5:21:47 AM, James wrote:

"The documentation itself has been created by Gavin Sinclair, William
Webber, Lyle Johnson, and library authors. Individual library files
usually have code and documentation credits."

You you pay $10 more for it? We decided not to go hardcover because we felt the market is fairly price sensitive. It's fairly easy to change, but the price (both of the book and shipping) would increase.

Cheers

Dave

···

On Dec 3, 2004, at 0:06, trans. (T. Onoma) wrote:

For Ruby 2 and Pickaxe III, I'd really like to see a high quality Hardback
special edition!

Cameron McBride wrote:

The available documentation either is is not acceptable; different people have different needs and criteria,

Right, and the message I was trying to convey is that 'I find it
acceptable and it's getting better'

but no one is served by making excuses.

Didn't mean to be, nor would I dare. ruby rocks. It needs none. Again, sorry for the confusion.

And I'm sorry if I came off as harsh or dismissive. I think I was having flashbacks to similar discussions some years ago, when someone posted a serious criticism of the state of ruby documentation, and there was a steady stream of, "Yes, but ..." answers, each trying to rationalize or explain away the issue.

The situation has improved immensely, and though there is still much more to be done, all involved should be quite proud of their work.

James

Gavin Sinclair wrote:

···

On Saturday, December 4, 2004, 5:21:47 AM, James wrote:

"The documentation itself has been created by Gavin Sinclair, William
Webber, Lyle Johnson, and library authors. Individual library files usually have code and documentation credits."

Oops, I gotta update that statement; there's been a few other
contributors in the last, oh... year? :slight_smile:

Has anything new in PickAxe II found a place in the core or stdlib docs?

James

Dave Thomas wrote:

You you pay $10 more for it? We decided not to go hardcover because we felt the market is fairly price sensitive.

I would. IT books are expensive anyway, so an additional ten bucks wouldn't matter to me. Not if it's a book that I use for a long time.

M.

I tell you what I'd pay $10-$20 more for is an edition with a
hardcover _and_ wire spiral binding so that it can be opened and lay
flat on the desk. I wish more programming guides would come this way;
it's really hard to type while you're holding a book open. :wink:

···

On Sat, 4 Dec 2004 13:17:07 +0900, Dave Thomas <pragdave@gmail.com> wrote:

You you pay $10 more for it? We decided not to go hardcover because we
felt the market is fairly price sensitive. It's fairly easy to change,
but the price (both of the book and shipping) would increase.

--
Regards,
John Wilger

-----------
Alice came to a fork in the road. "Which road do I take?" she asked.
"Where do you want to go?" responded the Cheshire cat.
"I don't know," Alice answered.
"Then," said the cat, "it doesn't matter."
- Lewis Carrol, Alice in Wonderland

I contributed _all_ of the core documentation from the initial version if Pickaxe II. It's in the source. Several folks helped enter and reformat it. I now leave it in the capable hands of the Ruby core team and the RDP to keep it up to date.

Cheers

Dave

···

On Dec 3, 2004, at 19:41, James Britt wrote:

Gavin Sinclair wrote:

On Saturday, December 4, 2004, 5:21:47 AM, James wrote:

"The documentation itself has been created by Gavin Sinclair, William
Webber, Lyle Johnson, and library authors. Individual library files usually have code and documentation credits."

Oops, I gotta update that statement; there's been a few other
contributors in the last, oh... year? :slight_smile:

Has anything new in PickAxe II found a place in the core or stdlib docs?

Wire binding would be nice. In the meantime, PickAxe 2 does have a layflat soft cover binding (we paid extra for it, so I know :). The copy I'm using here actually does stay open with no help from Chapter 1 through Appendix A.

Cheers

Dave

···

On Dec 6, 2004, at 8:17, John Wilger wrote:

I tell you what I'd pay $10-$20 more for is an edition with a
hardcover _and_ wire spiral binding so that it can be opened and lay
flat on the desk. I wish more programming guides would come this way;
it's really hard to type while you're holding a book open. :wink:

Dave Thomas wrote:

Has anything new in PickAxe II found a place in the core or stdlib docs?

I contributed _all_ of the core documentation from the initial version if Pickaxe II.

Many thanks.

James

···

On Dec 3, 2004, at 19:41, James Britt wrote:

Sadly, that wasn't my experience. :frowning: (Don't take that as a complaint
about the book, though.)

···

On Mon, 6 Dec 2004 23:35:49 +0900, Dave Thomas <pragdave@gmail.com> wrote:

On Dec 6, 2004, at 8:17, John Wilger wrote:

> I tell you what I'd pay $10-$20 more for is an edition with a
> hardcover _and_ wire spiral binding so that it can be opened and lay
> flat on the desk. I wish more programming guides would come this way;
> it's really hard to type while you're holding a book open. :wink:

Wire binding would be nice. In the meantime, PickAxe 2 does have a
layflat soft cover binding (we paid extra for it, so I know :). The
copy I'm using here actually does stay open with no help from Chapter 1
through Appendix A.

--
Regards,
John Wilger

-----------
Alice came to a fork in the road. "Which road do I take?" she asked.
"Where do you want to go?" responded the Cheshire cat.
"I don't know," Alice answered.
"Then," said the cat, "it doesn't matter."
- Lewis Carrol, Alice in Wonderland

I tried it after reading this. I had to press down a bit, to "break it
in", but then the book lay open flat. I think after a bit of use, it
should do it naturally.

Regards,
Nick

···

On Mon, 6 Dec 2004 23:49:28 +0900, John Wilger <johnwilger@gmail.com> wrote:

On Mon, 6 Dec 2004 23:35:49 +0900, Dave Thomas <pragdave@gmail.com> wrote:

>
> On Dec 6, 2004, at 8:17, John Wilger wrote:
>
> > I tell you what I'd pay $10-$20 more for is an edition with a
> > hardcover _and_ wire spiral binding so that it can be opened and lay
> > flat on the desk. I wish more programming guides would come this way;
> > it's really hard to type while you're holding a book open. :wink:
>
> Wire binding would be nice. In the meantime, PickAxe 2 does have a
> layflat soft cover binding (we paid extra for it, so I know :). The
> copy I'm using here actually does stay open with no help from Chapter 1
> through Appendix A.

Sadly, that wasn't my experience. :frowning: (Don't take that as a complaint
about the book, though.)

--
Regards,
John Wilger

-----------
Alice came to a fork in the road. "Which road do I take?" she asked.
"Where do you want to go?" responded the Cheshire cat.
"I don't know," Alice answered.
"Then," said the cat, "it doesn't matter."
- Lewis Carrol, Alice in Wonderland