At the time of writing libcontainer/README.md godoc was not that powerful. As a result, we have two sources of documentation -- the actual code and the README, and they are not always in sync.

It would be very beneficial to merge README contents into libcontainer source documentation.