Issues documents

Add documentation about any issues you encounter while doing this
project so the next group doesn't spend as much time pulling their hair
out as we have.