enhance docs, add comments to manager