tweak & move docs for 'attach' and 'detach'