Changes to the online book

April 19, 2013

GravatarBy Michael Snoyman

In preparation of the 1.2 release of Yesod, I've made a long-overdue change to this site: it now supports the display of multiple versions of the book. This should make it easier for users still sticking with a previous version of the framework. The plain /book URLs will always contain the most recent versions of the content, while /book-1.1, /book-1.2, etc, will be used for version-specific content. The two versions are currently identical, but I'll be making some changes over the coming weeks to the 1.2 version of the book.

For those of you who have poked around at the book content repo, I'm making one other important change right now: migrating the book content from DITA to DocBook. My motivations are twofold: there are more DocBook tools available than DITA in the open source community, and O'Reilly uses DocBook in their publishing process.

If anyone notices problems in the online book, please give me a heads-up.

Just because I can't get away without touting a Yesod 1.2 feature: multiple versions of the book is a perfect motivating case for using a subsite, as the exact same routing behavior can be reused for each version of the book. In this case, I just had each separate subsite point to a different Git branch. If you're curious to see this in practice, have a look at the commit introducing the subsites, and in particular the subsite routing file.


comments powered by Disqus