more docs and added attach algo