Pre release doc fixes

Doc and miscellaneous changes reviewed with Eleftherios in hangout