ISPN-3681 enhance the documentation of the new persistence API

* updated the SPI documentation
* updated the jdbc and file store to relfect the new names
* updated the javadoc links to point to 6.0