Introduce generic way to create pairs.
Improve documentation
Merge pull request #18 from cgaebel/pairs

Introduce generic way to create pairs.