45 积分 Tanja 对语言和技术都充满兴趣，多年来一直从事机械工程、医疗技术和 IT 领域的技术写作工作。 她于 2005 年加入 SUSE，为各种产品和项目文档做出了贡献，包括高可用性和云主题。 她很欣赏与来自不同背景和来自世界各地的人一起工作。 开源爱好者 作者
撰写的评论
谢谢您的评论！我完全同意多个入口点很重要，并且明智地使用索引和标题始终是一个好主意。
关于您的第二点：'foo bar' 示例的原始句子是
使用“grub2-mkpasswd-pbkdf2”加密密码。
您可以在开源峰会上我的演讲的幻灯片中找到更具体的示例（包括重新编写一段实际上取自现实世界示例的文档的练习）：https://schd.ws/hosted_files/osseu17/7a/Tech_Writing_OS_Summit_2017-10-…