Refactor test documentation and improve consistency in comments

updated with new prompts and new workflow to generate a document