Pytanie:
Jak radzić sobie z osobami, które nie będą czytać?
Sentinel
2019-01-30 03:35:05 UTC
view on stackexchange narkive permalink

Pracuję w branży, w której od czasu do czasu możesz mieć nagłe wymagania, aby przekazać wiele wysoce technicznych rzeczy. Czasami te rzeczy są naprawdę zaangażowane. Na przykład możesz rozmawiać o tym z ludźmi, ale wiesz, że następnego dnia nie omówisz wszystkich kątów, a połowa zostanie zapomniana.

Problem, którego doświadczam, polega na tym, że jakiś klucz ludzie nie będą czytać. Są to bardzo zdolni, techniczni ludzie, ale po prostu nie chcą lub nie mogą studiować analiz technicznych. Twierdzą, że tak, ale widzisz, że nic z tego nie uzyskali.

Co mogę zrobić, aby pomóc im przetrawić informacje, których potrzebuję, aby je przetrawiły?

Komentarze nie służą do rozszerzonej dyskusji;ta rozmowa została [przeniesiona do czatu] (https://chat.stackexchange.com/rooms/89221/discussion-on-question-by-sentinel-how-to-deal-with-people-who-will-not-czytać).
Moja odpowiedź została tutaj pozostawiona jako zmiana samego pytania.Mam nadzieję, że nie zginęło to na OP.
Siedemnaście odpowiedzi:
MacItaly
2019-01-30 03:46:05 UTC
view on stackexchange narkive permalink

Wygląda na to, że poziom zawiłości i szczegółowości dokumentów, które piszesz, przekracza mój obecny poziom wynagrodzenia, ale jako były nauczyciel w szkole średniej mam kilka wskazówek, które mogą pomóc. (Musiałem skłonić dzieci, żeby też spróbowały przeczytać!)

  1. Spróbuj utworzyć konspekt lub listę punktowaną, która podkreśli określone aspekty dokumentu, który chcesz, aby przeczytały. Podkreślając aspekty, a nawet mając pytania otwarte w punktach, pozwalasz ludziom odwoływać się do głównych punktów twojego dokumentu. Jeśli użyjesz pytania w podpunkcie, pomoże to wpłynąć na czytelnika, aby spróbował sam odpowiedzieć.

  2. Choć brzmi to głupio, pogrubione mocne > i kursywa to świetny sposób na przyciągnięcie uwagi czytelnika i podkreślenie tego, co próbujesz przekazać.

  3. Udostępnianie dokumentów i dodawanie komentarzy przez współdzielonych użytkowników pozwala zobaczyć, kto zwraca na siebie uwagę i kto wnosi wkład. Jeśli komentarze są włączone w Dokumentach Google lub innych udostępnianych aplikacjach, możesz zbierać informacje od innych osób, które je współtworzą.

  4. I wreszcie, zawsze jest stara dobra rozmowa. Zapytaj ludzi, którzy wydają się być niezdecydowani, czy istnieje powód, dla którego nie są w pełni zaangażowani. Wyraź znaczenie dokumentacji, działań następczych i dbałości o szczegóły. Miejmy nadzieję, że są wystarczająco dojrzali, aby również zrozumieć znaczenie.

Właściwie 2) i 3) naprawdę pomagają, a kiedy mogę 3) wydaje się działać najlepiej.To jak presja rówieśników.Problem polega na tym, że nie mogę tego zrobić w niektórych ważnych przypadkach, ponieważ te rzeczy mogą być wrażliwe z punktu widzenia bezpieczeństwa, a uderzenie w dokumenty Google byłoby prawie samobójstwem.
Ale właśnie tego szukam.Coś mi mówi, że ma to związek z „edukacją” bardziej niż z czymkolwiek innym… Wiesz, co mam na myśli?Niektórzy ludzie są technicznymi geniuszami, ale ich mózgi nie działają w jakiś sposób, więc potrzebuję innego sposobu.
Nadużywanie pogrubienia i / lub kursywy to świetny sposób na utrudnienie czytania tekstu - bądź ostrożny z tym tekstem.
Dodałbym (5) - jeśli jest to wystarczająco ważna treść, aby każdy miał czas na jej zrozumienie, zarezerwuj spotkanie (zajęcia / warsztaty) i * zaprezentuj * materiał, umożliwiając wszystkim zaangażowanym zadawanie pytań i angażowanie się w to.Wydaje się, że OP ma tylko „rozmowę” i „formalną wiadomość e-mail” w stylu komunikacji i może przydać się rozgałęzienie, jeśli jego zadaniem jest przekazywanie złożonych informacji technicznych.
Dodałbym zdjęcia, jeśli możesz: schematy blokowe, pseudokod, zdjęcia sprzętu, tabele statystyk, zrzuty ekranu interfejsu użytkownika, a nawet odpowiednie kreskówki.Po prostu coś, co pomaga ludziom poruszać się po dokumencie i inspiruje ich do przynajmniej przeczytania akapitów otaczających rysunek.Nie ma nic bardziej zniechęcającego niż więcej niż 5 stron pełnego tekstu.
Poleciłbym również zastanowić się, jakiej czcionki używasz - nawet w przypadku osób bez dysleksji czcionki przyjazne dla dysleksji mogą znacząco wpłynąć na łatwość czytania.Istnieje wiele materiałów, dzięki którym Twoje treści będą bardziej czytelne, wyłącznie z punktu widzenia formatowania, a to robi ogromną różnicę.
@L.S. Cooper Czcionki przyjazne dla dysleksji?Czy to jest rzecz?Hej, być może postawiłeś mnie tutaj na zwycięzcę.Czy możesz mnie z tym połączyć?
To, co powiedział Neil Slater, wzywając zebranych „zmusza” uczestników do poświęcenia czasu na materiał.W przeciwnym razie, gdy siedzą przy swoich biurkach i mają wybór, czy przeczytać dokument wymagający technicznie, czy usunąć zadania z talerza, dokument przegrywa.
To badanie (http://dyslexiahelp.umich.edu/sites/default/files/good_fonts_for_dyslexia_study.pdf) sugeruje, że Helvetica, Courier, Arial i Verdana to dobry wybór.Dyslexie to czcionka zaprojektowana specjalnie dla osób z dysleksją, ale w rzeczywistości jest znacznie trudniejsza do odczytania.I oczywiście jest niesławny Comic Sans, który podobno jest całkiem dobry dla osób z dysleksją.
Doskonałe sugestie.Większość czytelników będzie potrzebować tylko kilku kluczowych szczegółów z dużego dokumentu;zapewnienie im sposobu na szybkie znalezienie tych informacji jest najlepszym sposobem, aby upewnić się, że odwołują się do Twoich dokumentów.Oczywiście różni czytelnicy będą potrzebować różnych szczegółów.
Umiar może być kluczowy, ale jedyny komentarz z +40 tak się składa, że jest jedynym, który używa pogrubienia.Wziąłem próbkę ** pracy OP w SE: Nie używają formatowania ... + 1 **
Powinni także popracować nad sposobem dodawania linków.Podobnie jak [tutaj] (https://worldbuilding.stackexchange.com/a/127648/799), jedna to przynęta na kliknięcie (ponieważ nie ma takiego opisu w nawiasach), a druga jest niepotrzebnie długa (i nadalmuszę też to kliknąć, chyba że mogę odczytać łączony bełkot).
„konkretne aspekty dokumentu, które mają przeczytać” - niestety w przypadku specyfikacji technicznych nie da się obejść faktu, że trzeba przeczytać i zrozumieć całość.
Old_Lamplighter
2019-01-30 03:54:01 UTC
view on stackexchange narkive permalink

Być może częścią tego był twój styl pisania.

Przeczytałem i odpowiedziałem na wiele pytań na tej stronie, ale w rzeczywistości twoje było trudne do odczytania. Zastanawiam się, czy ma to coś z tym wspólnego.

Nawet Einstein powiedział: „Upraszczaj rzeczy tak proste, jak to tylko możliwe, ale nie prostsze”.

  • Przejdź do sedna poziom szczegółowości, który jest konieczny, ale nie więcej szczegółów niż to.
  • Podziel wszystko na najmniejsze fragmenty do przeczytania. Upewnij się, że czcionki są wystarczająco duże, kolory na wykresach są wyraźne, a dane mają znaczenie.
  • Jeśli to możliwe, podziel elementy na punkty.
  • PODAJ WAŻNE SZCZEGÓŁY WYJŚCIE
  • Poproś odbiorców o opinię.

Problem może dotyczyć Twojej prezentacji. Wyklucz to najpierw, zanim przypiszesz swoim współpracownikom jakiekolwiek lenistwo.

Jeśli faktycznie jest to Twoja prezentacja, przynajmniej możesz się tym zająć. Lenistwo, nie tak bardzo.

Komentarze nie służą do rozszerzonej dyskusji;ta rozmowa została [przeniesiona do czatu] (https://chat.stackexchange.com/rooms/89048/discussion-on-answer-by-richard-u-how-to-deal-with-people-who-will-nie przeczytane).
Ważny szczegół rzeczywiście się wyróżnia
Zwróć uwagę innych, że ta odpowiedź jest odpowiedzią na pierwotne pytanie, które zostało znacznie skrócone w wyniku edycji.
YetAnotherRandomUser
2019-01-31 03:56:39 UTC
view on stackexchange narkive permalink

Cały czas zmagam się z tym problemem. Pytałem nawet o to tutaj, tylko po to, żeby pytanie zostało zamknięte, odrzucone itp. Proponuję poddać się i pozwolić im upaść na twarz. A jeśli nie są całkowitą stratą, spotkaj się z nimi osobiście.

Osoby, które tego nie zrobią lub mogą 't czytać, nie bez powodu. Może to być apatia, analfabetyzm, uosobienie „zajętości” lub to, że podpisują twoją wypłatę i myślą, że powinieneś wykonywać swoją pracę bez zawracania im głowy.

Jeśli inni ludzie nie chcą lub nie mogą podejmij wysiłek, wszystkie sztuczki z innych odpowiedzi ci nie pomogą. To dobre sztuczki, które będą miały zastosowanie do osób, które potrafią i chcą czytać i / lub współpracować. Jednak osoby, z którymi masz problemy, uznają takie sztuczki za protekcjonalne lub będą zirytowane tylko dlatego, że przedstawiłeś im napisane słowa.

Źródło: Doświadczenie.

Kusi mnie, aby oznaczyć to teraz jako poprawną odpowiedź.Wiele z powyższych komentarzy zakłada, że nikt nie może czytać dokumentów, ale prawda jest taka, że większość z nich uważa je za łatwo przyswajalne, dobrze napisane i bardzo przydatne.Niewielka, ale ważna mniejszość nie będzie ich czytać.Nie zniechęcam się łatwo.Znajdę sposób, żeby zaangażować tych ludzi.Do tego czasu odpowiedź będzie otwarta.
@EthanBolker Wydawało się wystarczająco blisko, kiedy pierwszy raz się z nim toczyłem.Chodzi mi o to, by wskazać, że ludzie lubią wymyślać, że są zajęci, lubią sprawiać wrażenie zajętych, a nawet lubią być zajęci, ale jest to fałszywa przesłanka, ze stroną złośliwych cytatów z powietrza.Jest takie słowo, które zaczyna się od epy ... to była pierwsza autosugestia i na początku wydawało się istotne, ale teraz rozumiem twój punkt widzenia.
@EthanBolker Wygląda na to, że uosobienie nie jest słowem, więc utknąłem, chyba że możesz zasugerować jedno ...
@Philipp Przyjąłem to jako poprawną odpowiedź, ponieważ po refleksji jest najdokładniejsza: jeśli pracujesz na systemie, w którym głównym produktem jest specyfikacja protokołu, to ci, którzy nie poświęcą czasu na rozpoznanie tego faktu i dokonanie niezbędnej lekturyi pisania, są poza zasięgiem pomocy.Nie ma rozwiązania.Tych ludzi trzeba przypisać do ról, które polegają na testowaniu implementacji protokołu, a nie projektowaniu protokołu.(gdzie „protokół” może być dowolną specyfikacją, np. planem itp.)
@Sentinel W swoim poście twierdzisz, że „Problem, którego doświadczam, polega na tym, że wiele osób nie czyta”.Teraz mówisz, że to tylko niewielka mniejszość.Który to jest?Jeśli wypróbowałeś wszystkie inne sugestie i nie działają, zgadzam się, że powinieneś je zaakceptować, starając się jak najlepiej.Jednak ta odpowiedź, którą mogłem uznać za niewłaściwą, wydaje się sugerować, że nie warto próbować zmieniać rzeczy, mając nadzieję, że rozwiąże to problem.
@TheWanderingMind Ta odpowiedź mówi, że jeśli nie są CHCĄ, to wspomniane wcześniej wskazówki nie zadziałają, co oznacza, że warto spróbować.Myślę, że ta odpowiedź MOŻE poprawić sytuację.Jeśli drużyna wystarczająco upadnie na twarz, albo się rozpadnie, albo znajdą sposób na poprawę.
@Sentinel Jako programista cały czas projektuję specyfikacje protokołów, ale czytanie dużych tekstów mnie wypala, jestem bardziej praktycznym facetem.Muszę pobawić się wszystkimi danymi i funkcjami, aby dobrze zrozumieć, czego będzie wymagać specyfikacja.Jeśli chcę dowiedzieć się czegoś, czego potrzebuję w nadchodzących sprintach, przeglądam dokumenty, oglądam jeden lub dwa filmy, a następnie tworzę projekt testowy z danymi testowymi i zaczynam eksperymentować.Otwieram dokumenty i szukam konkretnych rzeczy, których używam, aby upewnić się, że ich nie nadużywam, ale nie mogę się niczego nauczyć w rozsądnym czasie z samego tekstu.
@Sentinel Być może twoi ludzie są tacy sami i czytanie jakiegoś dokumentu technicznego nie jest dla nich najlepszym sposobem na naukę?Czy potrafisz przygotować dla nich prosty plac zabaw?A może zakres jest na to za duży?Czy możesz rozbić sprawę na mniejsze części?Czy można je umieścić w grupie studyjnej, aby razem się uczyć?
@Kevin na pewno.Grać.program.Test.ALE.Musisz zaktualizować specyfikację na podstawie swoich ustaleń.Specyfikację należy utrzymywać na takim poziomie, aby można ją było przetłumaczyć na coś w celu wykonania formalnych dowodów.Czy potrafisz w pełni przeczytać wszystkie szczegóły i upewnić się, że aktualizacje są dokładne?
@TheWanderingMind Mój błąd.„dużo” jest mylące.Zaktualizowane pytanie.
@Philipp Brak odczytu komunikatów już dostarczonych jest winą jednej ze stron.
@Philipp Myślę, że ty i ludzie, którzy głosowali za twoim komentarzem, przeoczyliście ukryte subtelności mojej odpowiedzi, które późniejszy komentarz zarose wyjaśnia wyraźnie.
@YetAnotherRandomUser Poszedłbym dalej i zasugerowałbym, że na tej stronie istnieje niepotrzebna stronniczość wobec odpowiedzi, które słusznie stwierdzają, że w pewnych okolicznościach nie ma opcji.Sztuczki, takie jak zwoływanie spotkań i pogłębianie technicznych dokumentów projektowych za pomocą kolorowania kredkami lub podświetlania, nie wystarczą.
Czy odnosisz się do innych odpowiedzi tutaj przez * „wszystkie powyższe sztuczki” *?Jeśli tak jest, to nie działa.Ta odpowiedź została teraz zaakceptowana i otrzymała kilka głosów, więc kolejność jest inna.Czy możesz to naprawić (edytując swoją odpowiedź)?Na przykład.poprzez odniesienie do konkretnych odpowiedzi (prawdopodobnie najlepsze) lub użycie * „wszystkich sztuczek z niektórych poprzednich odpowiedzi” *.
Całkowicie się zgadzam.Pracowałem z tą samą frustracją przez kilka lat.Kilka razy rozmawiałem o tym z prezesem, ale to wcale nie pomogło.Doszedłem jednak do punktu, w którym zdałem sobie sprawę, że „jestem zbyt zajęty” działa w obie strony.Gdyby byli zbyt zajęci, aby przeczytać gazetę, ja byłem zbyt zajęty, aby im pomóc i nie zrobiłbym nic poza odsyłaniem ich do dokumentacji.Dyrektor generalny przyszedł do mnie kilka razy z powodu skarg na ten temat, ale wyjaśniłem sytuację, a on uważał, że moje działania były rozsądne, chociaż czasami zażądał wyjątku.
Alex Cruise
2019-01-30 08:16:24 UTC
view on stackexchange narkive permalink

Amazon ma fascynującą technikę rozwiązania podobnego problemu ... Nie oczekuj, że ludzie wstępnie przeczytają Twoje złożone pomysły, po prostu nie mogą poświęcić im uwagi, na jaką zasługuje, oni ” jesteś zbyt zajęty. Zamiast tego napisz podsumowanie propozycji / decyzji, zwołaj spotkanie, niech wszyscy tam usiądą i wspólnie je przeczytają, a potem będą mogli zadawać pytania.

„Wewnątrz nie są używane żadne PowerPointy firmy Amazon ”- deklaruje z dumą Bezos. „Ktoś na spotkanie przygotował sześciostronicową ... notatkę o strukturze narracyjnej. Zawiera prawdziwe zdania, zdania tematyczne, czasowniki i rzeczowniki - to nie tylko wypunktowanie”.

W jego Niedawny list do akcjonariuszy, Bezos szczegółowo opisuje pracę włożoną w te notatki, których napisanie i dopracowanie może zająć tydzień lub więcej:

„Wspaniałe notatki są spisywane i przepisywane, a następnie udostępniane współpracownikom którzy są proszeni o ulepszenie pracy, odłożenie na kilka dni, a następnie ponowna edycja ze świeżym umysłem. Po prostu nie można tego zrobić w dzień lub dwa. ”

[...]

„Podczas spotkania czytamy te notatki po cichu” - mówi Bezos. „To jak sala do nauki. Wszyscy siedzą wokół stołu i czytamy po cichu, zwykle przez około pół godziny, niezależnie od tego, ile czasu zajmie nam przeczytanie dokumentu. A potem o tym dyskutujemy.”

TL; DR: Zacznij od podsumowania.
Wątpię, aby spotkanie było pomocną strategią przekazania szczegółowych, twardych informacji technicznych, chyba że spotkanie bardzo różni się od normy.Trudno mi nawet zasnąć na spotkaniach.Nie każdy jest [Hansem Roslingiem.] (Https://www.ted.com/talks/hans_rosling_shows_the_best_stats_you_ve_ever_seen) I często nie wiadomo, który szczegół będzie ważny, dopóki nie będzie potrzebny.Moim zwykłym sposobem czytania informacji technicznych jest uzyskanie ogólnego przeglądu i ponowne dokładne przeczytanie odpowiednich części w razie potrzeby.
Więc ... są zbyt zajęci, aby wcześniej przeczytać dokument, ale najwyraźniej nie są zbyt zajęci, aby siedzieć w pokoju z grupą innych kierowników i po cichu czytać ten sam dokument?Co?!?Nie oblicza ...
Wygląda na to, że oznaczałoby to zmianę kultury korporacyjnej, na którą program operacyjny prawdopodobnie nie miałby wpływu.Mimo wszystko ciekawy pomysł!
@PeterA.Schneider Wygląda na to, że przeczytanie materiału wymaga po prostu czasu, nawet jeśli dyskusja nie jest szczególnie techniczna lub produktywna w kontekście, wymagany czas (tj. Priorytet usankcjonowany przez kierownictwo) jest prawdziwą korzyścią, a także sprawia, że ludzie są odpowiedzialni za ichOdpowiedzialność za treść lub decyzje techniczne, ponieważ każdy cię tam widzi, czytając je.
Właściwie to podejście ma dla mnie duży sens!Wszystkie szczegóły będą świeże w głowach wszystkich natychmiast po przeczytaniu dokumentu, więc rozmowa, która nastąpi, będzie szczególnie produktywna.Łatwiej jest skupić się na czytaniu, gdy wszyscy wokół ciebie również robią to w cichym pomieszczeniu.
@JeffC Siedzenie w pokoju i mówienie o nim prawdopodobnie ma dwojaki cel: 1: mówi ludziom, że jest to naprawdę ważne / priorytet biznesowy i nie można po prostu przejrzeć go 2: poprzez dosłowne zakończenie dyskusji tak blisko, jak to możliweczytając materiał, ludzie nie zapominają mniej i nie rozpraszają się tym, co mają na myśli.
@mbrig Planujesz spotkanie w celu omówienia i oczekujesz, że ludzie to przeczytają (nie przejrzeli) z wyprzedzeniem.To mówi wszystkim, że to ważne.Ludzie muszą być dorośli i zaplanować przeczytanie dokumentu przed spotkaniem, aby byli przygotowani i na tyle blisko spotkania, aby mogli je zapamiętać, itp. Innym sposobem radzenia sobie z tym jest opublikowanie dokumentu online i włączenie komentarzy.Osoby mogą dodawać komentarze przed spotkaniem.Daje to autorowi dokumentu szansę zaktualizowania dokumentu lub udzielenia odpowiedzi na komentarze przed spotkaniem.Następnie spotykasz się i omawiasz prawie ostatecznego doktora.
@JeffC i jak każdy, kto pracował w dużej korporacji, może ci powiedzieć, wyniki tej strategii są dość zróżnicowane.Waham się, czy odpisać coś, co działa na sukces i skalę amazon, przynajmniej nie biorąc tego pod uwagę.Chociaż amazon używając czegoś, oczywiście nie gwarantuje, że jest to rzeczywiście dobre.
@mbrig Nie mogę nie zgodzić się z tym, że to działa, bo przecież to Amazon, a on mówi, że działa.Wydaje mi się po prostu sprzeczne z intuicją, że zadziałałoby to inaczej niż zarezerwowanie czasu przed spotkaniem na przejrzenie dokumentu.Pracowałem w firmie Microsoft przez 10 lat i mogę powiedzieć, że niektórzy ludzie przyszli przygotowani, a inni nie, ale nigdy nie próbowaliśmy tego podejścia.Po prostu wydaje mi się to dziwne, ponieważ wydaje się polegać na fakcie, że ludzie nie są profesjonalni i nie można im ufać, że odpowiednio się przygotują.
Możesz mnie zaprosić na takie spotkanie tylko raz.Następnie piszę regułę w Outlooku, aby cię usunąć.
„Nie oczekuj, że ludzie wstępnie przeczytają Twoje złożone pomysły” - OP mówi o ludziach, których * praca * polega dosłownie na przeczytaniu i zrozumieniu tych rzeczy.
Dla mnie TLDR w tym zakresie polega na tym, że potrzebujesz autorytarnej kultury, w której egzekwowane są zasady dotyczące komunikacji.
zero298
2019-01-30 13:20:11 UTC
view on stackexchange narkive permalink

Nie zmuszaj ich do czytania. Nie jestem pewien, czy można to zastosować bezpośrednio do Twojej obecnej sytuacji. To, co mnie wyróżnia, to to, że chcesz, aby ludzie mogli stać się ekspertami w danym problemie za pierwszym razem lub kontynuować czytanie, dopóki nie zrozumieją. To nowość, ale tak jak tego doświadczasz, mało prawdopodobne. Prawdopodobnie nie ma na to czasu.

Myślę, że dobrą rzeczą, którą możesz zrobić, jest diagramowanie lub narysowanie czymkolwiek te rzeczy są, zamiast próbować opisać je tekstowo i wszystkie zawiłości.

Pracuję z wieloma elementami strony internetowej i czasami te elementy mogą mieć wiele podstawowych zasad biznesowych i przypadków narożnych. Czasy, w których generowanych jest najwięcej defektów, to sytuacje, w których musimy zbudować na podstawie wielkiej historii użytkownika wymiotów, która zawiera mnóstwo wymagań, co oznacza, że ​​nawet jeśli przeczytasz, ponownie przeczytasz, a nawet przeczytasz jeszcze raz, prawdopodobnie przegapisz coś kluczowego.

W jednym projekcie mieliśmy historie użytkowników, które faktycznie kolidowały z dokumentem projektu graficznego. Najczęściej to, co faktycznie zostało wdrożone, zostało wdrożone zgodnie z dokumentacją projektową, ponieważ można to było zrozumieć znacznie łatwiej i na pierwszy rzut oka. Miał wykresy przepływu, makiety interfejsu użytkownika i oczekiwaną funkcjonalność, ale źródłem prawdy miała być rzeczywista historia użytkownika, mimo że były one znacznie trudniejsze do odczytania.

Więc pierwszą rzeczą, która moim zdaniem pomogłaby, jest próba nakłonienia wszystkich do tablicy tych procesów i udokumentowania ich graficznie, zamiast pisania długich, nudnych tomów tekstu.


Zacząłem pracować z biblioteką o nazwie Rx, która zajmuje się danymi hydraulicznymi w funkcjonalny, reaktywny sposób. Czytałem dokumenty o tym, jak powinna działać hydraulika, dopóki nie zsiniałem. Jednak to, co naprawdę sprawiło, że całość się zatrzasnęła, to marmurowe diagramy wyjaśniające, jakie dane trafiają, gdzie, kiedy i dlaczego. Te diagramy są częścią podstawowej dokumentacji, a każdy operator / funkcja w bibliotece ma diagram, który odpowiada tekstowemu wyjaśnieniu funkcji, dzięki czemu możesz szybko zrozumieć rzecz, którą próbujesz zrozumieć, nawet jeśli tylko przeglądasz .

Skorzystaj z tego i spróbuj znaleźć sposób, aby widoki z lotu ptaka dawały wystarczająco dobry punkt widzenia na to, nad czym pracujesz, ale także zachęcają do czytania szczegółowego opisu. Mówisz, że niektóre z rzeczy, które próbujesz wyszczególnić, są takimi rzeczami, jak dowody matematyczne. Myślę, że musi istnieć sposób, aby opisać te rzeczy „w akcji” lub zastosować w taki sposób, aby ktoś mógł uzyskać pełne zrozumienie tego pojęcia użyj długiego opisu tekstowego, aby w pełni zrozumieć, co się dzieje.

Może po prostu lubię książki ze zdjęciami.

Ha!Uwielbiam Rx.NET :-) Diagramy marmuru to genialny wynalazek.Myślę, że masz rację.Muszę wymyślić coś, co będzie równie skuteczne, ale zastosowane w moim kontekście.Jeszcze inną możliwością byłoby zrobienie odpowiednika tworzenia wymagań pseudokodu.
Seth R
2019-01-30 04:30:25 UTC
view on stackexchange narkive permalink

Oprócz świetnej odpowiedzi @ MacItaly, chcę dodać dodatkowy punkt:

Przedstaw swój główny punkt na samym początku. Pierwsza rzecz, którą ktoś czyta w długim dokumencie powinno być podsumowaniem tego, o czym jest dokument. Pierwsze zdanie każdej sekcji powinno wskazywać na sedno sprawy, do której dąży ta sekcja. Wszystkie szczegóły, które łączą ten pomysł ze sobą, mogą pojawić się później.

Kuszące jest napisanie narracji, która buduje i buduje do spełnienia, zanim dojdzie do ostatecznego wniosku. W ten sposób powstają dobre historie i naprawdę, nawet najbardziej techniczne dokumenty po prostu opowiadają jakąś historię (nawet jeśli ta historia jest tak sucha, jak granice temperatury roboczej widżetu Beta-5A). Nie jest to jednak dobry sposób na przekazanie informacji, które mają przyswoić czytelnikom, ponieważ zakopuje główny punkt w ścianie tekstu. Nie zmuszaj czytelników do szukania rzeczy, które próbujesz wywnioskować, albo ich oczy zostaną zeszklone, zanim tam dotrą (jest to szczególnie prawdziwe w przypadku suchego dokumentu technicznego). Podaj to od razu, a następnie podaj szczegóły, które potwierdzają ten punkt.

Masz na myśli, uczynić całe moje pisanie tak, jak napisałeś tę odpowiedź?** Główny punkt z przodu ** oraz wszystkie powody, dla których warto to zrobić?Co za koncepcja!
@FreeMan czy to miało być sarkastyczne?
@WendyG nieco, ale także po to, aby podkreślić, że odpowiedź została napisana dokładnie tak, jak sugerował to w swojej odpowiedzi.Uważam, że jest bardzo skuteczny.(I zanotuję to na własny użytek.)
Staram się praktykować to, co głoszę.
To jest bardzo ważny punkt.Nie pamiętam, gdzie to usłyszałem, ale jak rozumiem, nauka działa najlepiej, gdy masz jakiś „haczyk”, na którym możesz zawiesić nowe informacje.Duży obraz z przodu daje ludziom haczyki, do których można przyczepić wszystkie szczegóły techniczne.
@L.S. Cooper, ludzie również mają skłonność do ślizgania się.Kiedy to robią, zwykle zwracają uwagę tylko na pierwsze zdanie dowolnego poddziału (strona, akapit, rozdział itp.) I na tej podstawie decydują, czy muszą dokładniej przeczytać resztę.Lubię pisać z założeniem, że większość ludzi przeczyta tylko pierwsze zdanie, które napiszę.Następnie pytam, jeśli jest tylko jedna informacja, z którą chcę, żeby wyszła, co to będzie?
Śliczny pomysł.Oto przykład dokumentu, który należy przeczytać.Ktoś tego nie przeczyta.Gdzie dodać główny punkt?https://tools.ietf.org/html/rfc793
@Sentinel Ten dokument zdecydowanie nie ** wymaga ** czytania.Nawet gdybym zmusił się do przeczytania tego dokumentu (nie zrobiłbym tego, nawet gdyby mój szef mi to kazał) nie byłbym bliżej zapamiętania czegokolwiek o TCP, niż gdybym po prostu próbował napisać aplikację za pomocą TCP i zobaczyć, jakie rzeczyposzło źle.Oba są nieco złymi sposobami uczenia się o TCP.Zamiast tego, gdybyś mógł dostarczyć prawdopodobnie niekompletny dokument, taki jak [ten] (https://en.wikipedia.org/wiki/Transmission_Control_Protocol), mógłbym faktycznie dowiedzieć się czegoś o TCP, którego mogę użyć, gdy go potrzebuję.
@Sentinel, Powiedziałbym, że autor tego wykonał całkiem niezłą robotę, umieszczając to we wstępie i pierwszym zdaniu wprowadzenia.
@Imus Jezu, NALEŻY to przeczytać, jeśli Twoim zadaniem jest sporządzenie fałszywego dokumentu.Nawet poprzez budowanie sieci TCP.Jak ciągle powtarzam, produktem końcowym jest specyfikacja, a nie sieć.
@Sentinel, więc mówisz, że masz grupę kujonów piszących nową specyfikację dla czegoś tak fundamentalnego jak TCP i nie możesz ich zmusić do przeczytania poprzedniej specyfikacji, aby mogli stworzyć nową?Jeśli tak jest, to założenie w twoim pytaniu poważnie pomogłoby uczynić twój punkt bardziej jasnym.
Lno to tylko analogia.Ludzie wciąż zakładają.Staram się powiedzieć bez wątpienia, że pomimo niepotrzebnych protestów niektórych komentarzy, dokumenty należy przeczytać.@YetAnotherRandomUser
@Sentinel Tak, odbieram to, ale kiedy jako przykład pominiesz RFC, kontekst znacznie się zmieni.Z basenu dla dzieci do klubu Multiple Gold Olympian, żeby użyć analogii pływania.
poeticvampire
2019-01-30 22:29:17 UTC
view on stackexchange narkive permalink

Jako autor tekstów technicznych i menadżer dokumentów piszę i przeglądam wiele wysoce technicznych dokumentów i oczekuję, że użytkownicy je przeczytają. Nie możesz zmusić ludzi do czytania. Ale są dwie rzeczy, których nauczyłem się, aby pomóc ludziom przebrnąć przez te ważne informacje.

  1. napisz dla kogoś z ulicy.
  2. zdjęcia, dużo, dużo obrazków.

W przypadku pozycji 1, jak wspomniano przez innych, wypunktowania, tabele, pogrubienie, podkreślenia, tego typu rzeczy naprawdę pomagają zwrócić uwagę na ważne części. Czasami wydłuża to dokument, ale jeśli ktoś, kto nie zna szczegółów, może zostać narysowany i uchwycić najważniejsze fragmenty, to pomaga.

Punkt 2. Nie mam na myśli tylko zdjęć, ale diagramy , schematy blokowe, ikony (jak w serii „dla opornych”), fragmenty kodu, cokolwiek. Znowu pomaga przyciągnąć wzrok, ale pomaga również tym, którzy uczą się wizualnie, a nie poprzez czytanie.

Również naprzemiennie między nimi i rozmieszczeniem na stronach. Te rzeczy również pomagają ludziom wrócić później, aby być może zajrzeć między siebie, aby znaleźć ważne fragmenty.

TLDR: nie tylko umieszczaj ścianę tekstu i oczekuj, że ludzie znajdą szczegóły w to. Rozbij to, aby ich oczy mogły złapać to, czego potrzebują.

Opierając się na komentarzach do pytania dotyczącego @DonQuiKong i JohnWu, sugerowałbym pamiętanie o UŻYTKOWNIKACH KOŃCOWYCH.Wygląda na to, że OP jest bardziej zainteresowany osobami technicznymi, które są już zaznajomione z projektem.Nawet jeśli jest to czysto wewnętrzne, wyobraź sobie, że wszyscy zostaliście potrąceni przez autobus, a wtedy nowi ludzie muszą to utrzymać!
Tak, pomyśl o tym przykładzie.masz zespół pracujący nad systemami kontroli automatycznego wyłączania elektrowni jądrowej, gdy warunki wewnętrzne staną się nienormalne.Gdy zespół opracowuje system, napotyka nowe lub nieoczekiwane wymagania dotyczące sposobu, w jaki system musi zostać zbudowany.Jednak każda zmiana musi skutkować odpowiednią zmianą w dokumentacji dotyczącej procedury ręcznego wyłączania dla technicznych użytkowników końcowych.Ci, którzy budują automatyczne procedury, muszą zweryfikować ręczne procesy.
Rozumiem, ale moje pisanie techniczne jest zwykle dla inżynierów.A w przykładzie Sentinela, właśnie w tym miejscu zrobiłbym coś takiego.Inżynierowie są leniwi (znam ich zbyt wielu i na początku nim byłem) nie zamierzają czytać wielu tekstów, ale nawet zupełnie nowy, dobrze wyszkolony inżynier może też nie znać procedur danej firmy.A więc tak, kiedy mówię o kimś „spoza ulicy”, który nie zawsze jest jak dziecko, tak, tak, musisz spodziewać się pewnego poziomu uprzedniej wiedzy.
@zarose A jeśli chodzi o potrącenie przez autobus, moja obecna firma miała właśnie taką sytuację, teraz piszę dużo dokumentacji, aby wypełnić lukę w tym, co uważali za „geniusz” dla inżynierów niskiego poziomu.
delliottg
2019-01-31 04:46:48 UTC
view on stackexchange narkive permalink

Walczę z tym również w mojej obecnej pracy. Trudno jest uzyskać odpowiedź za pośrednictwem poczty elektronicznej od prawie wszystkich osób w firmie. Sytuację pogarsza fakt posiadania biura satelitarnego oddalonego o setki mil. Prowadzimy z nimi spotkania na Skypie, ale wydaje się, że to niewiele pomaga. Uciekłem się do dyplomacji sneakersowej, wstań z mojego biurka & idź porozmawiać z osobą, od której potrzebuję informacji osobiście. Oczywiście próba zrobienia tego przez Skype jest w najlepszym razie niepewna.

Jedną z lepszych rzeczy, których nauczyłem się w marynarce wojennej USA w odniesieniu do komunikacji, było:

Powiedz im, co zamierzasz im powiedzieć. IE: Streszczenie lub TLDR

Powiedz im, co chciałeś im powiedzieć.

Powiedz im, co im powiedziałeś.

Nawet przy takim podejściu wciąż napotykamy problemy z osobami, które nigdy nie czytały e-maila zawierającego szczegółowe informacje o zmianach, jakie wprowadziliśmy w ich oprogramowaniu, oraz dlaczego otrzymujemy pytania. Jednak druga strona jest również prawdą, moja firma ma znakomite wyniki w znajdowaniu obejść, gdy coś nie robi tego, co powinno, i nie zawraca sobie głowy zgłaszaniem błędów dotyczących pierwotnego problemu, ponieważ znalazła obejście. Więc nawet nie wiemy, kiedy coś się zepsuło.

Np .: Pewnego razu jedna z naszych automatycznych maszyn do kalibracji przestała wykonywać kalibrację. Nasi technicy przeszli na ręczne wykonywanie kalibracji (dużo, dużo, dużo więcej czasu i podatności na błędy ludzkie) i nigdy nikomu nie powiedzieli, że maszyna nie działa prawidłowo. Mija rok , dzieje się dużo nadgodzin, ponieważ nie nadążają za obciążeniem pracą. Mój kolega (który kiedyś był technikiem kalibracji) jest pewnego dnia w laboratorium kalibracyjnym i zauważa, że ​​nikt nie używa oprogramowania do automatycznej kalibracji i pyta dlaczego. Technicy wyjaśnili, że był zepsuty przez „długi czas” i zamiast tego robili to ręcznie. Pięć minut dochodzenia wykazało, że dysk twardy był pełny, zapakowany na stałe, więc za każdym razem, gdy program był uruchamiany, próbował zapisać plik, nie mógł, błądził (mówiąc, że nie mógł zapisać pliku) i kończył pracę. Jest to zgodne z projektem, jeśli nie możesz pisać do plików, nie możesz przetworzyć kalibracji. Usunął około dziesięciu lat plików dziennika z maszyny, uwalniając kilka gigabajtów danych, i voila, automatyczna maszyna kalibrująca ponownie zaczęła działać.

Lol.Zastanawiam się, czy poprawność polityczna nie jest podstawowym problemem.Kiedyś, jeśli zespół pracował przez rok w godzinach nadliczbowych, ponieważ ktoś zignorował notatkę, ktoś straciłby swoje pieprzone przednie zęby i może obojczyk.
Problem polega na tym, że ta konkretna praca kalibracyjna jest początkowa, a rotacja jest wysoka.Rzadko się zdarza, aby ktoś trwał sześć miesięcy, więc wiedza plemienna jest stale tracona.Albo przeniosą się do innej pracy, albo awansują i trzeba przeszkolić inną technologię.Dowiedzieliśmy się również, że ludzie po prostu nie czytają komunikatów o błędach ani nie reagują na nie, więc w przypadku naszego nowszego oprogramowania mamy napisane przez nas oprogramowanie do automatycznego zgłaszania błędów, więc nawet jeśli ignorują błędy, nadal będziemy o tym wiedzieć.Ale nie całe nasze oprogramowanie ma taką możliwość, niektóre z nich zostały napisane dawno temu.
Oy.Powtarzanie niekoniecznie jest dobrą rzeczą, ponieważ myśląc, że prowadzi do zrozumienia, zwykle prowadzi tylko do nudy.Ta rada mówienia im z góry, co im powiesz, doprowadziła z mojego doświadczenia do dronowania w kółko, dwa razy.Tak, wyjaśnij, o czym będziesz mówić, ale w jednym zdaniu.Najwyżej akapit, jeśli jest niezwykle złożony
Zgadzam się z twoim zdaniem.Podsumowanie powinno być po prostu takie, krótkie i słodkie, a podsumowanie nie powinno już trwać.Jestem za mniejszą liczbą spotkań (w dużej mierze po prostu marnują mój czas), a jeśli muszę iść, krótkimi, które są na temat i nie zbaczają z tematu.
Re * „nasza zautomatyzowana maszyna do kalibracji” *: Kupiłeś oprogramowanie czy Twoja firma produkuje oprogramowanie?
Jeden, dla którego piszemy oprogramowanie.W tym przypadku napisane około 15-20 lat temu w VB przez osobę niebędącą programistą.To świetna zabawa w utrzymaniu.
Bazując na tym doświadczeniu, czy dodałeś sprawdzenie wolnego miejsca na dysku twardym (w aplikacji lub w jakiś sposób IT) lub przynajmniej lepszy komunikat o błędzie, wskazujący dokładną przyczynę (lub przynajmniej wspominając o możliwości w komunikacie o błędzie- wymagałoby to jedynie zmiany stałego tekstu)?(Aktualizacja aplikacji w terenie może, ale nie musi, być nietrywialna.)
Mefitico
2019-01-30 05:53:07 UTC
view on stackexchange narkive permalink

Pracuję w branży, w której pojawiają się podobne sytuacje. W przeciwieństwie do wielu odpowiedzi i prawdopodobnie w liniach pytania OP, ważne jest, aby zauważyć, że nie zawsze chodzi o twoje pisanie. Istnieją dokumenty techniczne i propozycje handlowe stron trzecich, które ludzie muszą przeczytać.

Problem polega na tym, że jeśli jesteś jedyną osobą czytającą dokument, nikt nie docenia włożonego wysiłku.

Środki zaradcze są indywidualne i w dużej mierze zależą od poziomu uprawnień w firmie. Jeśli jesteś nowym pracownikiem, sugerowałbym zwoływanie spotkań w celu omówienia dokumentów, w których najważniejsze informacje są pokazane w prezentacji. Masz swój punkt widzenia, ale ludzie mogą nadal tego nie czytać. Jeśli coś, co napisałeś, wymaga uwagi, nie spodziewaj się, że wszyscy przeczytają szczegółowo (szczególnie jeśli jest to coś, czego sam nie przeczytałeś raz), od czasu do czasu poproś godnego zaufania kolegę, może sięgnij do swojego przełożonego, mówiąc coś na wzór „ten raport potrzebuje recenzenta, ale wiem, że jest to bolesne, dlatego nie czuję się komfortowo pytając kolegę, jakby to była jego przysługa…”. Jeśli praca z czytaniem jest rzeczywiście konieczna, kierownik powinien przydzielić komuś zadanie czytania i odnotować, czy ta osoba wykonuje właściwą pracę.

Pamiętaj jednak, że być może cała ta lektura może nie być tak ważna, jak myślisz i prawdopodobnie nie każdy musi to robić dla wszystkich materiałów referencyjnych.

Jeśli jesteś menedżerem, istnieją inne sposoby na kultywowanie dyscypliny w zespole, ale z tekstu pytania wydaje się, że nie walizka.

Daj spokój.Zespół nie ma kierownictwa.Jest całkowicie samoorganizujący się, a członkowie otrzymują wynagrodzenie bez oceny.Wejście do zespołu zależy od zidentyfikowania słabych punktów w wytwarzanej rzeczy lub od podjęcia nowych możliwości, choć na zewnątrz.
jos
2019-01-30 21:33:18 UTC
view on stackexchange narkive permalink

Zastosowanie i iteracja

Podano już wiele dobrych odpowiedzi. Chciałbym skupić się na procesie przetwarzania informacji, a nie na prezentacji informacji.

Ludzie potrzebują czasu, aby przetrawić złożone informacje. Nawet przy bardzo dobrej prezentacji nie wszystkie informacje zostaną zachowane. Dobrym sposobem na naukę jest aplikacja. Aby wszystko trzymało się procesu, można użyć wielu iteracji czytania i stosowania.

Przykład procesu

  1. Przeczytaj, aby uzyskać główne pomysły.
  2. Spróbuj zastosować pomysły.
  3. Utknąć.
  4. Przeczytaj ponownie, aby uzyskać szczegółowe informacje. Nowe doświadczenie pomoże zrozumieć.
  5. Spróbuj ponownie złożyć wniosek

Powtarzaj kroki 3–5, aż informacje zostaną przetworzone.

William Jockusch
2019-02-01 07:03:16 UTC
view on stackexchange narkive permalink

Po pierwsze, jeśli ilość materiału technicznego jest duża, większość ludzi nie będzie mogła go szybko przyjąć. Pamiętam, że w szkole średniej zazwyczaj przeczytanie i zrozumienie bardzo technicznego materiału zajmowało mi zwykle 2-3 godziny na stronę .

To powiedziawszy, istnieją dwie ogólne klasy dokumentacji -

  1. Dokumentacja, którą ktoś właśnie napisał. Taka dokumentacja będzie zawierała niejasne zapisy, a nawet jawne błędy. Najlepszym sposobem na zrozumienie tego, co jest zamierzone, jest zazwyczaj napisanie testów jednostkowych i zadawanie pytań, gdy coś jest niejasne. Zachęcałbym ich do tego. Następnie, jeśli udzielisz odpowiedzi, można oczekiwać, że wykażą się zrozumieniem tej odpowiedzi za pomocą testu jednostkowego.

  2. Dokumentacja, która istnieje od dawna. W takim przypadku społeczność będzie istnieć. Możesz zachęcić ich do zadawania pytań tej społeczności.

Na koniec, jeśli jesteś w stanie szybko przeczytać i pojąć takie rzeczy, pamiętaj, że masz nietypowe talent i nie każdy może to zrobić.

Tak, to trochę obu, i tak, spodziewamy się, że ludzie spędzą dosłownie tygodnie na zrozumieniu, testowaniu, wdrażaniu i współtworzeniu tych planów.Problem w tym, że niektórzy wolą eksperymentować z implementacjami.
Upper_Case
2019-01-30 04:34:21 UTC
view on stackexchange narkive permalink

Dowody matematyczne są trudne do omówienia ustnie, chociaż jestem pewien, że nie wyobrażam sobie w pełni twojej sytuacji.

Moje sugestie:

  • Prośba napisana odpowiedzi w formie adnotacji do oryginalnego dokumentu

Dając ludziom czas na przeczytanie dokumentów, a następnie zapisanie ich przemyśleń, może pomóc Ci uzyskać bardziej formalne, uważne sesje czytania z Ci ludzie. Styl adnotacji zapewnia, że ​​łączą swoje odpowiedzi z rzeczywistymi częściami oryginalnego dokumentu (mniej miejsca na nieporozumienia, a te, które są obecne, będą łatwiejsze do znalezienia).

Wspomniałeś w komentarzach, że ludzie które opisujesz, może wolisz nie odpowiadać w ten sposób, ale wygląda na to, że ich preferencje nie są dla ciebie do obrony. Jeśli musisz zmusić ich do większego zaangażowania, może to być sposób, aby to się stało.

  • Pisz wspólnie

Ludzie czyta coś. Jest to trudniejsze, jeśli piszesz to. Jeśli te osoby są odpowiedzialne za pewne sekcje lub jeśli masz spotkania, na których wszyscy wspólnie omawiają sekcje, prawdopodobnie możesz skłonić ich do większego zaangażowania się w dokumenty. To trochę jak nadzór, ale bardzo lekki.

  • Ostatecznie nie możesz wymusić wysiłku intelektualnego

To raczej na marginesie, ale możesz Nie zmuszaj ludzi do myślenia i generalnie istnieje granica tego, jak bardzo możesz skondensować dokładne informacje. Jeśli nie są wystarczająco zmotywowani, aby zrobić to samodzielnie, dodanie jakiejś zachęty, aby to zrobili, może być jedynym sposobem, aby skłonić ich do ochotniczego podjęcia wysiłku. Może być potrzebny jakiś mechanizm nagradzania wysiłku (lub karania za niepowodzenie).

Mikey
2019-01-30 21:22:55 UTC
view on stackexchange narkive permalink

Dodaj streszczenie dla kierownictwa

Pracowałem w regionie świata, w którym czytanie nie było tradycją i nikt nie czytał przed zatwierdzeniem / przyjęciem moich dokumentów / programów.

Więc umieściłem PowerPoint (proste kropki ze zdjęciami) podsumowania, oprawiłem je, nadałem mu ładny wygląd i załączyłem go na górę całego dokumentu. Personel przejrzał go pod kątem dokładności i kompletności, decydenci przeczytali piktogram zawierający 10 slajdów.

Czytanie nie było tradycją?Co oznacza, że większość populacji nie była piśmienna?
Re * „region świata, w którym czytanie nie było tradycją” *: Na podstawie rzeczywistych doświadczeń, pasowałoby to do [Toronto] (https://en.wikipedia.org/wiki/Toronto), Kanady.
@YetAnotherRandomUser - bardzo dobrze wykształcony;piśmienny;ale w Zatoce istnieje tradycja upraszczania (urbanistyka jest moją dziedziną) i szybkiego podejmowania decyzji, co wymaga od nas przedstawiania wizualnych i ustnych prezentacji z zaufaniem, że jesteśmy ekspertami w swojej dziedzinie i nasze zalecenia są słuszne.
user98871
2019-01-31 13:42:38 UTC
view on stackexchange narkive permalink

Odpowiedź Mefitico zawiera kilka doskonałych uwag, ale chciałem również założyć, że zachęty do czytania dokumentów mogą nie być odpowiednio rozważone. Wspomniałeś, że w tej sytuacji nie ma menedżera, ale prawdopodobnie istnieje pewna ocena wydajności - jeśli „dogłębna lektura” materiałów i tak nie zapewnia wystarczających korzyści w stosunku do wyprzedzania, ludzie będą optymalizować, unikając tego. Sugeruje to, że dogłębna lektura nie jest w rzeczywistości wymagana do skutecznego wykonywania pracy, a przynajmniej nie jest mierzona jako taka.

Jedną rzeczą, która pomaga mi w pracy, jest to, że jako inżynier powiązać konkretne cele z wymaganym zrozumieniem materiałów; to jeden ze sposobów, aby upewnić się, że czytane są odpowiednie części dokumentu. Na przykład, jeśli celem jest „Uruchom Algorytm XYZ na zestawach danych A, B i C” i masz wzmiankę o Algorytmie XYZ, jest to prawdopodobnie najszybsza droga do osiągnięcia tego celu. Ale jeśli poprosisz mnie o przeczytanie tego samego dokumentu na temat algorytmu XYZ bez poświęcania czasu na jego przeczytanie lub bez celu związania go z nim , będzie on bardzo nisko na liście priorytetów.

user53651
2019-01-31 03:06:36 UTC
view on stackexchange narkive permalink

Proste, po prostu przypomnij im, gdzie mają przeczytać informacje za każdym razem, gdy mają z nimi problem lub za każdym razem, gdy ich nie wiedzą. W końcu, dzięki sile powtarzania, ludzie zaczną po prostu kojarzyć czytanie z nauką.

Poza tym musisz upewnić się, że twoja dokumentacja jest dobrze napisana, w przeciwnym razie nie ma ilości RTFM (Przeczytaj pełną instrukcję) sprawi, że ktoś to przeczyta; ludzie nie będą czytać rzeczy, które powodują krwawienie z oczu.

Kevin
2019-01-31 21:46:14 UTC
view on stackexchange narkive permalink

Wina leży po stronie czytelnika lub w piśmie lub w obu. Ponieważ twoje pytanie tak naprawdę nie sugeruje, na czym polega problem, trudno jest zaproponować rozwiązanie. Mówisz, że czytelnicy są kompetentni, ale zostawiaj otwarte, czy odmawiają czytania, czy nie są w stanie przeczytać materiału. Jeśli to pierwsze, pytanie brzmi: dlaczego? (Ograniczenia czasowe? Leniwe? Inne rzeczy są przyjemniejsze?) Jeśli to drugie, sugeruje, że są nie kompetentne.

To, co możesz zrobić, zależy od tego, ile potrafisz wpływać na autora (ów) i / lub czytelnika (ów). Jeśli problem jest ściśle związany z komunikacją, doskonałą książką jest „Jak czytać książkę” Mortimera J. Adlera. Skorzystaj z zawartych tam informacji, aby zachęcić autorów do ułatwienia życia swoim czytelnikom poprzez dobre pisanie, oraz aby zachęcić czytelników wskazówkami, jak lepiej wykorzystać to, co czytają, i jak najlepiej wykorzystać to, co czytają. Istnieją ogólne zasady, które odnoszą się nawet do dzieł, które nie są książkami. Nie mogę wystarczająco polecić tej książki.

Kolejnym przewodnikiem po dobrym pisaniu jest „The Elements of Style” Strunk and White.

drjpizzle
2019-02-04 19:35:39 UTC
view on stackexchange narkive permalink

Spojrzenie z drugiej strony płotu:

W poprzedniej pracy miałem wiele dokumentów, które „potrzebowałem” do przeczytania. Zazwyczaj wymagania przechwytują dokumenty projektowe itp. Często ich nie czytałem po przejrzeniu.

Dlaczego? Często „potrzebne” w tym kontekście brzmiało: „pomogło autorowi”.

Na przykład chcieli, aby ich projekt był używany, ponieważ zyskał uznanie i wzmocnił zdanie „Rozwiązuję trudne problemy, po prostu zaimplementował to „widok procesu. Jeśli tak jest: świetnie. Ale wtedy nie masz problemu. Przeczytałem dokument, bo ja też. W praktyce często dokument był albo:

  • Fuff, który tak naprawdę powtórzył coś, co otrzymał autor (do którego też miałem dostęp).

  • Niekompletny do użycia.

  • Był rozsądny i rozsądny, ale:

    • Nie dotyczy sposób, w jaki zamierzałem wejść w interakcję z projektem.

    • Sytuacja została już zmieniona i trudna do „powrotu na właściwe tory”.

  • Czasami: źle, sprzecznie lub głupio.

Po tym, jak zacząłem ignorować ogromne ilości rzeczy, które prawdopodobnie powinienem był czytać i robić po swojemu, średnio wydawało mi się to działać lepiej.

Warto zwrócić uwagę na kilka rzeczy:

  • To niekoniecznie musi bądź taki, jaki jest , tak jak jest postrzegany.

  • Nie musi to być cokolwiek, co zrobiłeś . Kiedy myślisz: „to jeszcze jedna rzecz, za którą muszę się wypowiedzieć, zanim będę mógł zająć się naprawianiem rzeczy”, będziesz walczył z żmudną walką. Nie tylko dlatego, że nie przeczytają go, aby się dowiedzieć, ale zabarwi to, jak czytają, kiedy to zrobią. Na przykład podkreślasz, że muszą przeczytać dokumenty. Mając otwarty umysł, można to łatwo przeczytać: „Nie robienie tego dla firmy / projektu będzie miało znaczące wady, których nie uwzględniłem, ponieważ nie są one istotne / konieczne”. Jednak moja pierwsza myśl była sceptyczna, przed którą ostrzegam. Nie mogę wiedzieć, ale kiedy zaczniesz widzieć wzorce ...

  • Chociaż czas spędzony na czytaniu był czynnikiem, był tylko bardzo mały. To frustrujące, gdy mówi się: „zrób to w ten sposób, z takim skutkiem”, gdy te dwa elementy wzajemnie się wykluczają, bez względu na to, jak zwięźle to ułożysz.

Więc co można robisz:

Ładnie pytaj i wyjaśnij, dlaczego jest to korzystne dla wszystkich / ich. To nigdy nie boli, a jeśli jest to kwestia motywacji, zwłaszcza jeśli problem polega na tym, że postrzegają siebie jako osoby spoza pętli, może to przejść długą drogę.

Uzyskaj, jeśli możesz, informację zwrotną, co to jest jest to powoduje opór. Może to być coś, czego nie da się naprawić, ponieważ po prostu nie dbają o to wszystko, ale myślę, że to mało prawdopodobne (gdyby naprawdę ich to nie obchodziło, nie wypadliby jako techniczni i kompetentni, co wymaga chociaż trochę zaangażowania). Myślę, że znacznie bardziej prawdopodobne jest, że możesz to naprawić. Oczywiście nie mogę mówić w imieniu wszystkich, ale: nie widzę siebie niechętnie dzieląc się swoimi zastrzeżeniami i zastanawiam się, jak postępować na forum, które moim zdaniem dotyczy rozwiązywania problemów, a nie przypisywania winy.



To pytanie i odpowiedź zostało automatycznie przetłumaczone z języka angielskiego.Oryginalna treść jest dostępna na stackexchange, za co dziękujemy za licencję cc by-sa 4.0, w ramach której jest rozpowszechniana.
Loading...