For samples, documentation, and usage information, please see http://ehcache.org.
We released the Milestone 3 on September 18th, 2015. In addition to the JSR-107 compatibility, it introduces up to 3 level tiering, offering offheap as well as a new disk persistence option; write-behind, XA transactional caches, makes custom serialization possible, …
The release notes contain the links to the documentation to help you get started
We are now working on the next milestone : Automatic Resource Control will be the big item in this upcoming release.
See the milestones on GitHub for more details on the current status.