Looks like the documentation is still in progress: http://g.raphaeljs.com/reference.html

but the demos are pretty impressive.