Polish lib docs.
Polish lib docs.

* Add an example showing simple graph creation and algorithms.
* Add an explanation of what "weights" mean.
* Add feature flag docs.
* Copy edit pass on existing verbiage.

petgraph/petgraph,bluss/petulant-avenger-graphlibrary