DOC: added more notes useful for others