For the most part each Ray release is “compatible” with the previous one. Occasionally though things change between versions, you can find out all about what “breaking” changes the latest version has here.
In some cases, a shortcut that existed in Ray 1.x will no longer be present in Ray 2.×. Although the command is still there in long form you may find this to be a particular hassle, in that case please create a ticket complaining about it and I’ll give you your shortcut back.
All users of the extension bundling mechanism will need to update their
extensions.yml before Ray 2.x can understand them. This is mainly because the original format was not very well considered; you’ll find most of your updating gets done with the delete key.
For example, the old demonstration
extensions.yml which looked like:
--- - name: aggregation - name: link-roll - name: help hub: saturnflyer - name: markdown hub: johnmuhl lib: rdiscount vendor: markdown_filter - name: page_attachments plugin: attachment_fu plugin_repository: technoweenie lib: mini_magick - name: blog hub: netzpirat remote: saturnflyer/radiant-blog-extension
In Ray 2, the same
extensions.yml looks basically the same; just with more less:
--- - name: aggregation - name: link-roll - name: help - name: markdown - name: page-attachments lib: mini_magick - name: blog hub: netzpirat remote: - saturnflyer
You don’t need to list the
lib on the RDiscount Markdown filter because it declares it's own dependencies. For an extension that requires a gem but doesn’t declare it’s dependencies you’ll still need to use the
Users of previous versions may notice that the commands have changed. While this appears to be the case it’s not actually (mostly). All the same old commands are available, so if you got comfortable with
rake ray:extension:install name=mailer and don’t want to switch to
rake ray:i name=mailer you can keep right on using the long versions. You can get a reminder of the shortcuts with the
rake ray:help:shortcuts command.