pending issues addition

adding some document links and more questions we need to discuss