Some changes to documentation

According to our discussion outside of GitHub, you're planning to modify the API involving append and merge, so I'm going to refrain from doing changes to the documentation that makes use of these.