adding doc and improving put election