Faster Havel-Hakimi generator and directed version too.
Add docs for directed Havel-Hakimi generator and small doc fixes.
Merge pull request #817 from hagberg/706-generators

Directed Havel-Hakimi generator.

Addresses #706