Browse files

[docs] add about-examples.pod

  • Loading branch information...
1 parent f2592f4 commit 538e442704e0bd6e80cb1fa30407bcd49ba24f8d @moritz moritz committed Oct 8, 2009
Showing with 29 additions and 0 deletions.
  1. +29 −0 docs/about-examples.pod
@@ -0,0 +1,29 @@
+=head1 NAME
+About examples used in the book
+Good examples live at the heart of our book, so it's worth thinking hard about
+At the initial brainstorming meeting we agreed that the JSON::Tiny module
+would make a good example (which doesn't imply we'll actually use it). Here's
+=item it solves a real world problem, and it solves it (nearly) completely
+=item it's short enough to comfortably fit into a book
+=item it uses fairly idiomatic Perl 6 without overdoing it
+=item it uses some nice features (grammars, action methods, multi dispatch)
+Our examples should fulfill as many of these criteria as possible.
+In particular we B<don't> want the usual Mammal examples for inheritance,
+C<$foo> and C<bar()> as names (though C<pub>s are fine).

0 comments on commit 538e442

Please sign in to comment.