We will have  migration guide ready before we will announce the general availability of catkin.
A draft (which is very likely to change in the near future) can currently be found in the github repository of catkin (https://github.com/ros/catkin/tree/master/doc - especially in 
rosbuild_migration.rst).
Some further information from the design phase is available at http://ros.org/doc/fuerte/api/catkin/html/
Please keep in mind that the development is currently still ongoing and some things are likely to change...

- Dirk


> As one of the most experienced *users* of catkin, could you write up
> some guidelines and tips for those new to catkin to follow? Even just
> a few of the most important things you've discovered. You've found how
> to do certain things "the catkin way," and having that knowledge
> available for newcomers might help lessen some of their concerns.
>
> Geoff
> _______________________________________________
> ros-users mailing list
> ros-users@code.ros.org
> https://code.ros.org/mailman/listinfo/ros-users
>