Improved interface documentation as per Dan