Updated user's guide with new API
attempt to move examples to new API
fixed FAQ ref