Technical writing: Difference between revisions

From LemonWiki共筆
Jump to navigation Jump to search
No edit summary
No edit summary
Line 17: Line 17:
* Copy & paste the commands from the documentation
* Copy & paste the commands from the documentation
** The PDF will insert the line break into the command if the length of command is too long<ref>[https://stackoverflow.com/questions/18599711/how-can-i-split-a-shell-command-over-multiple-lines-when-using-an-if-statement syntax - How can I split a shell command over multiple lines when using an IF statement? - Stack Overflow]</ref>
** The PDF will insert the line break into the command if the length of command is too long<ref>[https://stackoverflow.com/questions/18599711/how-can-i-split-a-shell-command-over-multiple-lines-when-using-an-if-statement syntax - How can I split a shell command over multiple lines when using an IF statement? - Stack Overflow]</ref>
== Related pages ==
* [[Customer communication]]


== References ==
== References ==

Revision as of 10:14, 30 October 2023


icon_scale_pencil.png This article "Technical writing" is still being written. If there are any incomplete parts, you are welcome to directly edit them. 這篇文章「Technical writing」內容還在撰寫中,如果有不完整的部分,歡迎你直接動手修改


Software installation guide checklist

  • Requirement of software and hardware[1]
  • Package dependency
  • Expected result after the software installed successfully
  • Troubleshooting

Software documentation checklist

  • Steps by steps process and screenshots
    • Is it possible to reduct the total number of steps in order to reduce the cognitive load?
  • Verify the entry point before using the software
  • Copy & paste the commands from the documentation
    • The PDF will insert the line break into the command if the length of command is too long[2]

Related pages

References