Rewrite of docs in Chain interface

It would be nice if the experts could review the new docs to see if they are accurate. #162 gives some context about all this. 

I've also expanded `TestLongPdbVsMmCifParsing` in integrationtest module, in order to test issues described in #162 . At the moment the test doesn't pass (but anyway it is excluded from standard mvn install)