add a doc to handle the new issues