Adding doco to close an existing ticket

closes #1456