Driven by an interest in both language and technology, Tanja has been working as a technical writer in mechanical engineering, medical technology, and IT for many years. She joined SUSE in 2005 and contributes to a wide range of product and project documentation, including High Availability and Cloud topics. She appreciates working with people from different backgrounds and from around the globe.
Authored Comments
Thank you for your comments! I fully agree that multiple entry points are important and that using indexes and headings wisely is always a good idea.
Regarding your second point: The original sentence for the 'foo bar' example is:
Encrypt the password using 'grub2-mkpasswd-pbkdf2'.
You can find more concrete examples in the slides that accompanied my talk at the Open Source Summit (including the exercise of re-writing a piece of documentation that was taken actually taken from a real-world example): https://schd.ws/hosted_files/osseu17/7a/Tech_Writing_OS_Summit_2017-10-…