clarifying reference implementation stuff