update wave document with some issues