fixed warning and note and refreshed doc