View source for Why's (poignant) Guide to Ruby

{{short description |Introductory book to the Ruby programming language}}
{{DISPLAYTITLE:''why's (poignant) Guide to Ruby''}}
{{Use American English |date=February 2024}}
{{Use dmy dates |date=February 2024}}
{{More citations needed |date=February 2024}}
[[Image:why's foxes.png|thumb|why's foxes]]
'''''why's (poignant) Guide to Ruby''''', sometimes called '''''w(p)GtR''''' or just "the poignant guide", is an introductory book to the [[Ruby programming language]],<ref name="ftb23" /> written by [[why the lucky stiff]]. The book is distributed under the [[Creative Commons]] Attribution-ShareAlike license.

The book is unusual among programming books in that it includes much strange humor and many narrative side tracks which are sometimes completely unrelated to the topic. Many motifs have become inside jokes in the Ruby community, such as references to the words "chunky bacon". The book includes many characters which have become popular as well, particularly the cartoon [[fox]]es and ''Trady Blix'', a large black feline friend of why's, who acts as a guide to the foxes (and occasionally teaches them some Ruby).

The book is published in [[HTML]] and [[Portable Document Format|PDF]]. Chapter three was reprinted in ''The Best Software Writing I: Selected and Introduced by [[Joel Spolsky]]'' (Apress, 2005).

== Contents ==
# About this book
# Kon'nichi wa, Ruby
# A Quick (and Hopefully Painless) Ride Through Ruby (with Cartoon Foxes): basic introduction to central Ruby concepts
# Floating Little Leaves of Code: evaluation and values, [[Associative array|hashes]] and lists
# Them What Make the Rules and Them What Live the Dream: case/when, while/until, variable scope, blocks, methods, class definitions, class attributes, objects, modules, introspection in [[Interactive Ruby Shell|IRB]], dup, self, {{Not a typo|rbconfig}} module
# Downtown: [[metaprogramming]], [[regular expression]]s
# When You Wish Upon a Beard: send method, new methods in existing classes

The following chapters are "Expansion Packs":

# The Tiger's Vest (with a Basic Introduction to IRB): discusses IRB, the interactive Ruby interpreter.

== References ==
{{reflist |refs=
<ref name="ftb23">{{cite web |title=Why's (Poignant) Guide to Ruby |year=2023 |website=FreeTechBooks |url=http://www.freetechbooks.com/why-s-poignant-guide-to-ruby-t222.html |access-date=2024-02-07 }}</ref>
}}

== External links ==
{{commons}}
* [https://web.archive.org/web/20090813201826/http://poignantguide.net/ruby Original Site]
* [http://poignant.guide/ Actively maintained fork]
* 3rd-party PDF version: [http://www.rubyinside.com/media/poignant-guide.pdf Ruby Inside]

{{Ruby programming language}}

[[Category:Computer programming books]]
[[Category:Creative Commons-licensed books]]
[[Category:Ruby (programming language)]]
[[Category:Books about free software]]

{{compu-book-stub}}