Skip to content

Instantly share code, notes, and snippets.

@moritz
Last active October 22, 2016 14:45
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save moritz/2930131695511e6b5ec63d90e4ce9e7b to your computer and use it in GitHub Desktop.
Save moritz/2930131695511e6b5ec63d90e4ce9e7b to your computer and use it in GitHub Desktop.
Ramblings on writing a Perl 6 book

I'm crazy. I'm considering another attempt at a Perl 6 book.

Most readers of my ramblings are probably aware that I was one of the now abandoned Using Perl 6 book effort.

It was mostly abandoned because we had about 4 to 5 core authors, and interest and/or available time from most authors waned. I'm no exception here.

Experiences Gained

In December 2015 I've decided to write [https://deploybook.com/](a book on Continuous Delivery). It is now feature complete, and in the editorial phase. Since I didn't know if I'd make it, I consider this a success so far.

From writing the book, I've learned that designing the process the keep me motivated was very important. These were the things that kept me motivated:

  • I limited the scope from the beginning, so I had the feeling I was making real progress towards the finished book. (And whenever I thought, "huh, maybe I should also talk about $related-topic", my mental response was "maybe in a follow-up book").
  • I started the book as a commercially oriented project. Which mostly meant that I collected email addresses for a mailing list, and when I had the feeling I had something of value, I put it up on leanpub and started to sell copies. Having paying customers (and the metric of number of people on the mailing list) motivated me far more than people on #perl6 telling me they liked the book
  • I had a cycle of blogging about a topic first, and later distilling it into a part of the manuscript. That helped me get around my imposter syndrome, because my standards for blog posts aren't as high as for book material. Writing the manuscript directly feels sooo much harder for me.
  • I found an editor (thanks [ptc]!) who gave me good feedback. That also motivated me.
  • The activities around the tooling (rendering the book through latex as PDF) were rather distracting. I just want to write my book in Markdown, and let somebody else worry about the rendering (leanpub or so at first, maybe a publisher later).

What does that mean for a potential Perl 6 book?

  • I want to limit the scope too. So "Perl 6 OO in a Nutshell", rather than a full "Perl 6 in a Nutshell" (just an example; I'm not settled on that format).
  • I want to keep the blog first approach, and use the blog to collect email addresses. I know some people frown upon that, but nobody has to give me their email address.
  • I want to start selling copies on leanpub (or comparable platforms) very early. It hugely motivates me, and Open Sourcing can happen later, optionally.

Target Audience

Somebody who already has some experience with other programming languages.

I don't I can overcome the Curse of Knowledge in this area, and teach the very basics of programming successfully.

Time Horizon

I'll likely be able to start writing around mid December 2016.

Open question: Topic and Style

The actual topic and style of the book is very open right now. I could imagine a "Using Perl 6"-style book, which is example first, explanation later. Or "Perl 6 OO in a Nutshell". Or "Solving 10 problems in Perl 6". Or whatever.

What kind of Perl 6 book would you like to read, and pay for?

What kind of Perl 6 book would you co-author with me?

Which brings me to my last topic

Coauthor wanted

I'd like to not do this alone. There are several reasons:

  • Working together makes it easier to stay motivated
  • I consider myself to be rather proficient in Perl 6, but I often feel my writing could be better. Having somebody to balanced these traits could be beneficial.
  • Two authors == twice the fun!

Please let me know what you think, either as a comment here, or per email (moritz.lenz@gmail.com), or on IRC (nick moritz on freenode).

@MasterDuke17
Copy link

I would love a book on concurrency. I think the high level primitives Perl 6 offers are rather unique and potentially a huge drawing point for new users. jnthn's slide deck and the docs are a good intro, but more examples and in-depth explanation would be great.

@moritz
Copy link
Author

moritz commented Oct 9, 2016

Thanks for your comment, @MasterDuke17. I'm pretty sure though that concurrency won't be the focus, mostly because

  • I'm not convinced it's stable enough in Rakudo
  • the market probably needs something more beginner-oriented
  • I'm too uncomfortable with the topic itself, to the point where I don't know if my solutions are idiomatic

(It might still get a chapter though).

@tbrowder
Copy link

tbrowder commented Oct 9, 2016

I would love to have a book on essential/ beginning Perl 6: including such things as more on containers, from essential to advanced idioms, how to create, how to test for contents, how to acces and modify contents, etc.

Each blurb on containers should follow the same format for easy comparison for use decision. Emphasize pitfalls of using various operators, especially boolean due to differing precedence versus container methods, etc.

I woud be happy to help review and do basic editing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment