improve top level documentation