adds more descriptiveness to deploy doc
adds a bit more to deploy doc
improves readme, adds annotate gem, annotates user model.
fixes rdoc markdown