snap warnings fixed, doc updated
documentation