[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"detail-sidebar-cat-0-en-105":3,"doc-seo-676557-105":59,"doc-detail-676557-en":129},{"code":4,"msg":5,"data":6},0,"success",[7,13,18,23,28,33,38,43,48,51,55],{"id":8,"doc_module":4,"doc_module_name":9,"category_name":10,"show_sort_weight":11,"slug":12},1,"Document","Story & Novel",90,"story-novel",{"id":14,"doc_module":4,"doc_module_name":9,"category_name":15,"show_sort_weight":16,"slug":17},2,"Literature",80,"literature",{"id":19,"doc_module":4,"doc_module_name":9,"category_name":20,"show_sort_weight":21,"slug":22},4,"Exam",70,"exam",{"id":24,"doc_module":4,"doc_module_name":9,"category_name":25,"show_sort_weight":26,"slug":27},5,"Comic",60,"comic",{"id":29,"doc_module":4,"doc_module_name":9,"category_name":30,"show_sort_weight":31,"slug":32},6,"Technology",50,"technology",{"id":34,"doc_module":4,"doc_module_name":9,"category_name":35,"show_sort_weight":36,"slug":37},7,"Healthcare",40,"healthcare",{"id":39,"doc_module":4,"doc_module_name":9,"category_name":40,"show_sort_weight":41,"slug":42},8,"Research & Report",30,"research-report",{"id":44,"doc_module":4,"doc_module_name":9,"category_name":45,"show_sort_weight":46,"slug":47},9,"Religion & Spirituality",20,"religion-spirituality",{"id":46,"doc_module":4,"doc_module_name":9,"category_name":49,"show_sort_weight":46,"slug":50},"World Cup","world-cup",{"id":52,"doc_module":4,"doc_module_name":9,"category_name":53,"show_sort_weight":52,"slug":54},10,"Lifestyle","lifestyle",{"id":56,"doc_module":4,"doc_module_name":9,"category_name":57,"show_sort_weight":24,"slug":58},19,"General","general",{"code":4,"msg":60,"data":61},"ok",{"site_id":62,"language":63,"slug":64,"title":65,"keywords":66,"description":67,"schema_data":68,"social_meta":122,"head_meta":124,"extra_data":126,"updated_unix":128},105,"en","tech-writing-handbook-chapter-0-welcome","Tech Writing Handbook - Chapter 0 - Welcome","","Tech Writing Handbook teaches how to create effective technical communication, covering planning, drafting, writing, and publishing for manuals, how-to guides, work instructions, and service documentation. The handbook emphasizes avoiding common pitfalls like poor preparation and outdated publishing, and argues that strong instructions combine visual, modern design with subject-matter understanding. Early chapters stress learning the product and process firsthand, consulting experts, and iterating drafts through closer engineer-writer collaboration.",{"@graph":69,"@context":121},[70,84,104],{"@type":71,"itemListElement":72},"BreadcrumbList",[73,77,79,82],{"item":74,"name":75,"@type":76,"position":8},"https://docshare.wps.com","Home","ListItem",{"item":78,"name":9,"@type":76,"position":14},"https://docshare.wps.com/document/",{"item":80,"name":30,"@type":76,"position":81},"https://docshare.wps.com/document/technology/",3,{"item":83,"name":65,"@type":76,"position":19},"https://docshare.wps.com/document/tech-writing-handbook-chapter-0-welcome/676557/",{"url":83,"name":65,"@type":85,"image":86,"author":91,"headline":65,"publisher":94,"fileFormat":97,"inLanguage":63,"description":67,"dateModified":98,"datePublished":98,"encodingFormat":97,"isAccessibleForFree":99,"interactionStatistic":100},"DigitalDocument",{"url":87,"@type":88,"width":89,"height":90},"https://docshare.wps.com/thumbnails/tech-writing-handbook-chapter-0-welcome/676557.png","ImageObject",300,407,{"name":92,"@type":93},"miaandmiso","Person",{"url":74,"name":95,"@type":96},"DocShare","Organization","application/pdf","2026-11-04",true,{"@type":101,"interactionType":102,"userInteractionCount":4},"InteractionCounter",{"@type":103},"ViewAction",{"@type":105,"mainEntity":106},"FAQPage",[107,113,117],{"name":108,"@type":109,"acceptedAnswer":110},"What is the core goal of the Tech Writing Handbook?","Question",{"text":111,"@type":112},"It teaches how to write manuals and instructions that actually help readers learn tasks, from planning through publishing, while avoiding common technical writing pitfalls.","Answer",{"name":114,"@type":109,"acceptedAnswer":115},"Why does the handbook say you should “know thy product and process”?",{"text":116,"@type":112},"Because you can’t teach someone how to do something until you’ve done it yourself and understand how the product or process works.",{"name":118,"@type":109,"acceptedAnswer":119},"How does the handbook recommend improving the manual beyond a first draft?",{"text":120,"@type":112},"It recommends frequent, faster interactions between engineers and writers so the final document benefits from iterative feedback rather than a slow, wasteful draft-and-rip-apart cycle.","https://schema.org",{"og:url":83,"og:type":123,"og:title":65,"og:site_name":95,"og:description":67},"article",{"robots":125,"canonical":83},"index,follow",{"doc_id":127,"site_id":62},676557,1793776080,{"code":4,"msg":5,"data":130},{"doc_id":127,"user_id":131,"nickname":92,"user_avatar":132,"doc_module":4,"category_id":29,"category_name":30,"doc_title":65,"doc_description":67,"doc_content":133,"file_id":134,"file_url":135,"file_type":136,"file_size":137,"view_count":4,"is_deleted":4,"is_public":8,"is_downloadable":8,"audit_status":8,"page_count":138,"language":139,"language_code":63,"site_id":62,"html_lang":63,"table_of_contents":140,"faqs":141,"seo_title":142,"seo_description":67,"update_tm":128,"read_time":143},7971478544854,"https://ap-avatar.wpscdn.com/davatar_994ba38a5ba835b3df7d355c54d3ed8d","Tech Writing Handbook  \nAuthors  \nKyle Wiens, CEO, iFixit  \nJulia Bluff, Lead Writer, iFixit  \nTech Writing Handbook  \nThis handbook will teach you how to create everything from manuals to work instructions. We’ll help you avoid the most common pitfalls of tech writing, from poor planning to outdated publishing.  \nAuthors  \nKyle Wiens, CEO, iFixit  \nJulia Bluff, Lead Writer, iFixit  \nBrought to you by   \nChapter 0  \nWelcome! ................................................................... 3  \nChapter 1  \nLook before you write ......................................... 5  \nChapter 2  \nBe concise ................................................................. 7  \nChapter 3  \nCrystal clarity .......................................................... 10  \nChapter 4  \nCommunicate with style....................................13  \nChapter 5  \nKnow your audience ............................................17  \nChapter 6  \nPhotograph the process ....................................19  \nChapter 7  \nUse visuals ................................................................ 25  \nChapter 8  \nOrganize your content........................................ 30  \nChapter 9  \nLegal requirements .............................................. 34  \nChapter 10  \nHow to publish........................................................ 36  \nChapter 11  \nAfter you write ........................................................ 40  \nAppendix A: Deep dive Manufacturing work instructions .................42  \nTech Writing Handbook 3  \nCHAPTER 0  \nWelcome!  \nSo, you’ve decided to write a manual. We extend our hand in hearty congratulations of the do-it-yourself moxie that led you here. Welcome to the world of technical communication!  \nNow, at this very moment, you may be chuckling to yourself,“Technical communication … Isn’t that an oxymoron?”  \nWe get it. Bad manuals happen … a lot. It’s a universal experience: You take Junior’s Christmas gift out of the box, crack open the assembly manual, and, suddenly, everything goes horribly, horribly wrong. Three hours later, all you have to show for your effort is a mutant tricycle. Junior will not be pleased.  \nThe best way to learn something is to have an expert teach you. But manuals are the next best thing. Great manuals, like the ones from iFixit or Mackie, are teachers.  \nTech Writing Handbook 4  \nAnd we suspect that’s why you’re here. You want to write a manual that actually teaches people how to do things.  \nWe want to help. This program will teach you how to write how-to guides, work instructions, and service manuals—from planning, to writing, to publishing. We’ll also help you avoid the most common pitfalls of tech writing.  \nManuals are important. Whether you’re writing about how to perform maintenance on a CNC machine, use video editing software, bake a soufflé, or rebuild an engine, you’re teaching someone something new. If your manual succeeds, the reader will have done something that wasn’t possible without your help. And that’s pretty amazing.  \nTech Writing Handbook 5  \nCHAPTER 1  \nLook before you write  \nWriting effective instructions is an achievement. Modern instructions shouldn’t just be a list of useful directions. They embrace the aesthetic and conventions of our time: highly visual, sleek, interactive, and well-designed. And when they’re done right, they’rea pathway to empowerment.  \nRight now, you’re probably excited to get writing. But before you start galloping off into the tech writing sunset, know this: most of the manuals and guides out there are written by people who have no firsthand knowledge of the subject matter. We think that’s a problem. It takes more than just writing skill to write a good manual: it also takes understanding. There are two laws of tech writing:  \n1. Know thy product and process  \n2. Talk to thy experts  \nKnow thy products and process  \nThe first requirement for tech writing is knowledge. You can’t teach someone how to do something until you’ve done it yours","cbCaitRXaNmVEAzB","https://ap.wps.com/l/cbCaitRXaNmVEAzB","pdf",2041195,48,"English","# Chapter 0\n## Welcome!\n# Chapter 1\n## Look before you write\n# Chapter 2\n## Be concise\n# Chapter 3\n## Crystal clarity\n# Chapter 4\n## Communicate with style\n# Chapter 5\n## Know your audience\n# Chapter 6\n## Photograph the process\n# Chapter 7\n## Use visuals\n# Chapter 8\n## Organize your content\n# Chapter 9\n## Legal requirements\n# Chapter 10\n## How to publish\n# Chapter 11\n## After you write\n# Appendix A\n## Deep dive Manufacturing work instructions","[{\"question\":\"What is the core goal of the Tech Writing Handbook?\",\"answer\":\"It teaches how to write manuals and instructions that actually help readers learn tasks, from planning through publishing, while avoiding common technical writing pitfalls.\"},{\"question\":\"Why does the handbook say you should “know thy product and process”?\",\"answer\":\"Because you can’t teach someone how to do something until you’ve done it yourself and understand how the product or process works.\"},{\"question\":\"How does the handbook recommend improving the manual beyond a first draft?\",\"answer\":\"It recommends frequent, faster interactions between engineers and writers so the final document benefits from iterative feedback rather than a slow, wasteful draft-and-rip-apart cycle.\"}]","Tech Writing Handbook - Chapter 0 - Welcome | PDF",121]