changes fed through from documentation update