Docs and a few bug fixes

The pending work  in docs / rsts ...
A few bug fixes along the way ...