The Javadoc is a great source of documentations.
This API relies heavily on generated code from this schema. If you understand XML schmea, then you
should take a look at the schema, it will give you some insights on how objects are mapped to xml and
vice versa.
Yes, it's supported by a special feed reader called CachedFeedReader, which extends FeedReader.
It supports conditional get and basic caching, see here for more information.