updated the document based on stephan's comments