updated docs & salt implementation