Move common_neighbors out of link_prediction

The interface is also modified to return an iterable.
Reference link_prediction in documentation
Merge pull request #1148 from ysitu/link-prediction-doc

Move common_neighbors out of link_prediction and add link_prediction in generated documentation