I don't mind having the simple examples in the API docs, but we already have them in the user guide.  Is the duplication alright to have?