added most of Lynn's comments and KT's support doc

KT's support doc is probably not final, so this will need to be updated.