documentation update about changing existing code;  the interface is the same, but the types will be different, so code dealing with types will have to change