wal: add a doc file

@unihorn Yea, I want to document how it should work, we need to fix the thing #1045 is addressing.