wr0ngway/rubber — Issue #109: Documentation Wish List
Author: jackkinsella
Created: 2011-10-15 00:35:43+00:00
State: open

I'm very excited about Rubber and I think it could become the default choice for deploying Rails apps which don't fit nicely on Heroku, such as apps that require specific binaries. Rubber seems solid as software but I found the documentation hard to follow, particularly because I don't have sys admin experience and was setting up an EC2 instance for the first time. I suspect people falling into this category would be one of the key markets for this gem. Some suggestions I came up with:

1) Fix cap -T / the wiki page so that the descriptions of the commands are not clipped in half.
2) Explanation of how to try out different vulcanize packages, ideally without having to wipe a server. I couldn't find a way to do this so ended up having to switch IPs for my host every time I tried out different packages.
3) Explanation of how to add your own capistrano tasks to extend it. I couldn't figure this out.
4) Explanation of how to get delayed job working with monit in your setups. I must have tried literally 30 different monit files, and the all failed.
5) Explanation of two questions asked initially (web01 and web,app,primary=true) and what you should choose in different scenarios (e.g. the default options would be where you are putting up a single VPS). I wasn't clear what names I should choose, and what the consequences of my choice were. What happens if I just choose "web"? Or if I just choose "web,app"? Id didn't know.