aboutsummaryrefslogtreecommitdiff
path: root/content/posts/2004-03-23-pickaxe-ii-feedback.html
diff options
context:
space:
mode:
authorPaul Duncan <pabs@pablotron.org>2021-10-14 12:47:50 -0400
committerPaul Duncan <pabs@pablotron.org>2021-10-14 12:47:50 -0400
commit4b6c0e31385f5f27a151088c0a2b614495c4e589 (patch)
tree12243cdcd00704bc1a9d94ac9cc128459417370c /content/posts/2004-03-23-pickaxe-ii-feedback.html
downloadpablotron.org-4b6c0e31385f5f27a151088c0a2b614495c4e589.tar.bz2
pablotron.org-4b6c0e31385f5f27a151088c0a2b614495c4e589.zip
initial commit, including theme
Diffstat (limited to 'content/posts/2004-03-23-pickaxe-ii-feedback.html')
-rw-r--r--content/posts/2004-03-23-pickaxe-ii-feedback.html57
1 files changed, 57 insertions, 0 deletions
diff --git a/content/posts/2004-03-23-pickaxe-ii-feedback.html b/content/posts/2004-03-23-pickaxe-ii-feedback.html
new file mode 100644
index 0000000..1df7241
--- /dev/null
+++ b/content/posts/2004-03-23-pickaxe-ii-feedback.html
@@ -0,0 +1,57 @@
+---
+date: "2004-03-23T14:11:00Z"
+title: PickAxe II Feedback
+---
+
+<p>
+<a href='http://www.pragdave.com/'>Dave Thomas (pragdave)</a> is
+soliciting feedback for a second edition of <a
+href='http://www.rubycentral.com/book/'>Programming Ruby</a> (<abbr
+title='also known as'>aka</abbr> the "PickAxe"). Here's what he's
+saying on the <a href='http://www.ruby-talk.org/'>ruby-talk</a> mailing
+list:
+ </p>
+
+<blockquote cite='http://www.ruby-talk.org/95560'>
+<p>
+So, this is what I'm thinking. Rather than document all the methods in
+all the lib/ and ext/ classes and modules, I'd like to have a one-page
+summary for each. Each page would contain a synopsis of the function of
+the library, along with a small number of samples of use. The idea is
+that you can read through this to find libraries that would be useful,
+and then consult the RDoc for details. Think of it as a kind of
+exhaustive library cookbook. I've posted sample pages at
+
+<p>
+&nbsp;&nbsp;&nbsp;<a href='http://www.pragmaticprogrammer.com/extracts/sl.pdf '>http://www.pragmaticprogrammer.com/extracts/sl.pdf </a>
+</p>
+
+<p>
+(These are rough, and contain typesetting problems and other errors---I
+just wanted to give folks a feel for what I was talking about).
+</p>
+
+<p>
+So, here's the question: is this the way to go? Are folks happy seeing
+this kind of synoptic information in the book, and then referring to
+the online or local documentation for the details? (Don't worry about
+the built-in stuff: I'm keeping the existing format for all of that, so
+you'll still have the complete method listing for String, Array, and
+friends).
+</p>
+</blockquote>
+
+<p>
+The full message (and thread) is available <a
+href='http://www.ruby-talk.org/95560'>here</a>.
+</p>
+
+<p>
+<b>Update:</b> Apparently the <a
+href='http://www.ruby-talk.org/'>ruby-talk</a> archive code is a bit
+behind; the link is correct, but the message isn't archived yet. At the
+moment, there's nothing on the <a
+href='http://www.ruby-talk.org/'>ruby-talk</a> archive page dated past
+March 19th.
+</p>
+