Return self from CollectionDecorator#replace

Closes #516
Remove outdated documentation

Closes #522
Merge pull request #524 from haines/replace

Return self from CollectionDecorator#replace