Wiele osób uważa, że aby być dobrym pisarzem technicznym, musisz być ekspertem w dziedzinie tematu. I chociaż jest to powszechne nieporozumienie, nie jest zaskoczeniem, że ludzie mają to przekonanie.Po tym wszystkim, twoim zadaniem jako pisarza technicznego jest przekazywanie złożonych, technicznych informacji do publiczności w sposób, który jest łatwy do strawienia. Na szczęście rzeczywistość polega na tym, że nie musisz być MŚP, aby napisać artykuł techniczny światowej klasy. Potrzeba to ciekawość, struktura i chęć zadawania fachowcowi właściwych pytań.I to jest piękno pisania technicznego: zadawanie właściwych pytań jest ważniejsze niż posiadanie wszystkich odpowiedzi. do Nie-SME Przewodnik po wielkiej historii technicznej Branszuj swój brak wiedzy jak broń Ten brak wiedzy, o który tak bardzo się martwisz, daje ci interesującą korzyść – możliwość podejścia do tematu z tym samym i Zadajesz pytania, które eksperci zapominają zadać (tych, których Twoi czytelnicy też cicho pytają), kwestionujesz każdą koncepcję, rozbijasz żargon na prosty język i wypełniając własną lukę w wiedzy, dajesz czytelnikowi najlepsze doświadczenie. greenness curiosity https://ucatt.arizona.edu/news/curse-knowledge?embedable=true Budowanie relacji z ekspertem ds. przedmiotów Ustaliliśmy, że nie musisz być MŚP, aby napisać świetną historię techniczną, ale Musisz zbudować związek z tą osobą (lub zasobem).Potrzebujesz połączenia z mózgiem za projektem technicznym / tematem, o którym piszesz.Ktoś, kto wie wszystko, co trzeba wiedzieć o temacie. someone Twoim zadaniem jest być mostem między wglądami tej osoby a Twoimi czytelnikami. Ale oto rzecz o małych i średnich przedsiębiorstwach: często żyją głęboko w złożoności własnych systemów.Jesteś tam, aby wyciągnąć te informacje i przetłumaczyć je na coś, co podróżuje. Zaufaj, że dokładnie reprezentujesz ich pracę, zadajesz przemyślane pytania i będziesz traktował ich czas z szacunkiem. build trust. Jak komunikować się z MŚP Zrób najpierw zadania domowe.Nie pojawiaj się na spotkaniu MŚP na pustym miejscu.Czytaj, badaj i przygotuj się na konkretne, inteligentne pytania. Zapytaj „dlaczego” więcej niż „co”. „Co” mówi ci, co zostało zbudowane; „dlaczego” mówi ci, dla kogo jest i dlaczego ma to znaczenie. Wyjaśnij terminologię natychmiast. Nie wprowadzaj w błąd. Niewłaściwe użycie terminów w części technicznej może zrujnować wiarygodność. Podsumuj po każdym wywołaniu. Wyślij krótkie śledzenie z tym, co zrozumiałeś i upewnij się, że jesteś na tej samej stronie. Tłumaczyć, nie transkrybować Kiedy jesteś gotowy, aby umieścić pióro na papierze, musisz pamiętać, że twoim zadaniem nie jest rzucać żargon eksperta na stronie. W praktyce oznacza to usunięcie żargonu na prosty język. czytelnik będzie dotknięty produktem / usługą, a nie całą ciekawą technologią, która go napędza. jak Zamiast mówić, Powiedz mi, „Produkt XYZ jest świetny, ponieważ został zbudowany z najnowocześniejszej, pierwszej w swoim rodzaju blah blah.” "Produkt XYZ, zbudowany z najnowocześniejszych blah blah, jest świetny, ponieważ pomaga w wykonywaniu ABC." Pierwsza linia uszczelnia technologię, druga służy czytelnikowi. Na koniec dnia budujesz most między wiedzą ekspercką a codziennym zrozumieniem.Im jaśniejszy most, tym więcej ludzi może go przekroczyć. Sprawdź fakty, jak od tego zależy twoje życie Nie jest to opcjonalne, zwłaszcza dla nie-MŚP. Opowieści techniczne zależą od dokładności. W przeciwieństwie do prozy, twoje fakty muszą być w 100% prawdziwe i weryfikowalne, twój kod MUSI działać, a twoje przykłady MUSIĄ być odtwarzalne. Uruchom wszystko – zrzuty ekranu, fragmenty kodu i statystyki – z powrotem do eksperta w celu potwierdzenia. Grałeś w grę zaufania, a nic nie eroduje go szybciej niż błąd, który mógł zostać złapany za pomocą jednej wiadomości e-mail. Opowiedz historię (Keyword, “Story”) Po sprawdzeniu faktów zbuduj historię. W ostatecznym rozrachunku pisma techniczne są . pisanie A to oznacza, że potrzebuje struktury, przepływu i wypłaty. (problem lub cel), rozwinąć (Twoje procesy lub odkrycia) i blisko (wgląd lub działanie ) why how what next Aby ułatwić sprawy, zbudowaliśmy praktyczny przewodnik oparty na tej dokładnej strukturze trzech aktów. Zacznij od tego tutaj: Technical Storytelling Writing Template. Get started with it here: . Technical Storytelling Writing Template Techniczne opowiadanie pisania template Na koniec: zadawaj dobre pytania, pisz tak, jakbyś to wyjaśniał znajomemu, a jeśli kiedykolwiek zapomnisz, od czego zacząć, pamiętaj, że jasność z każdym razem zwycięża złożoność. Mamy nadzieję, że to dało Ci trochę jasności (i uspokoiło twoje obawy) o nawigacji w branży pisania technicznego bez wiedzy na temat tematu. Do następnego razu!
