Repository navigation
Zmeczenie recenzenta - #276
andrzejniewiaro wants to merge 17 commits into
Conversation
7914fee to
936cf37
Compare
| coverImage: | ||
| --- | ||
|
|
||
| Czytanie własnej lub cudzej dokumentacji stanowi lwią część warsztatu technical |
There was a problem hiding this comment.
Ja bym rozumiał, że warsztat stanowią umiejętności i narzędzia, a tutaj chyba mówimy o tym, że czytanie dokumentacji zajmuje dużo czasu.
Chyba, że "umiejętność czytania" stanowi dużą część warsztatu.
There was a problem hiding this comment.
Troche przedwczesnie zrobilem ten PR, glownie po to zeby zrobic rebase.
Jest, jeszcze surowy ale dzieki, moze szybciej ustale o co mi w nim chodzi :)
There was a problem hiding this comment.
mam pomysl na wprowadzenie tej mysli. tak, zwykle myslac "Warszat" wyrozniamy umiejetnosci i narzedzia. Chce przyjrzec sie temu, na co nie zwracamy swiadomie uwagi: jako dokumentalista, bardzo duzo czytasz. czytasz trudne tickety, specyfikacje, dokumentacje, czytasz to co napiszesz czy wygenerujesz.
czytanie to podstawowa czynnosc ale w tym kontekscie ma specjalne znaczenie. mysle ze uda mi sie to sprzedac :)
There was a problem hiding this comment.
dobre tropy, na pewno coś Ci się uda z rego zrobic. daj znać kiedy będziesz chciał review.
można robić rebase lokalnie, komendami w gicie. możesz sobie o tym poczytać i wybrać sposób, który Ci najbardziej odpowiada. ja zawsze ustawiam rebase jako defaul strategy on pull i robie git pull origin main
| od dokumentacji, jak tylko dostatecznie dobrze zapoznasz się z tematem. | ||
|
|
||
| Za dodatkową trudność uważam to, że nasz mózg stara się oszczędzać energię. | ||
| Autor dokumentacji czyta swój materiał największą liczbę razy. Łatwiej skupić |
There was a problem hiding this comment.
Wydaje mi się, że twierdzenie, że mózg oszczędza energię jest mocno oddzielone o informacji o tym jak ją oszczędza i te zdania pomiędzy wydają się być nie na temat, aż się przeczyta dalszy ciąg. Możesz rozważyć przesunięcie pierwszego zdania bliżej zdania "Analiza tekstu wymaga dużo wysiłku" lub jeszcze jakoś to inaczej napisać. Bo zajawka na początku akapitu jest ciekawa i warto by ją było nadal mieć na początku.
There was a problem hiding this comment.
tak, musze to uporzadkowac.
tez chce uzyc paru materialow naukowych, bo tez moje wyobrazenie o tym coc robi mozg ma krotkie nogi, bo nie jestem mozgologiem ;)
| W kontekscie komunikacji technicznej widzę też "reviewer's block" (znużenie | ||
| recenzowaniem materiału). | ||
|
|
||
| Z pewnością nie wyczerpuję tu listy pułapek, jakie stoją przed autorem |
There was a problem hiding this comment.
Wydaje mi się, że kolejne akapity w tej sekcji nie są ułożone w żadnej specjalnej kolejności i czyta się je jak luźne i niezwiązane ze sobą uwagi. Może chcesz na to rzucić świeżym okiem później i spróbować ułożyć je w jakąś narrację?
There was a problem hiding this comment.
tak, to jest na mojej 2DO list.
| przetestować go pod kątem persony odbiorcy. Być może w ten sposób | ||
| zidentyfikujesz brakujące elementy i aspekty, które mogą wymagać poprawy. | ||
|
|
||
| Gdy GenAI wskaże Ci fragmenty, które trzeba przeczytać ponownie, być może |
There was a problem hiding this comment.
Można by tu jeszcze dodać, ze GenAI —a konkretnie LLM — będzie sugerował jak najbardziej "średni" tekst pozbawiony znaczników osobistego stylu. Można by się tu pokusić o jakiś przykład — jeden akapit napisany wyraziście i ten sam akapit tak jak AI zasugeruje go napisać.
Chyba, że "styl pisania AI" to jest temat na osobny artykuł? 🤔
There was a problem hiding this comment.
to dobra uwaga o tej "sredniosci" bo przypomina ze, LLM daje inne uwagi niz konkretny czlowiek.
oks, wplote to jakos choc niekoniecznie dawalbym przyklad, bo odbiegamy od glownego tematu.
Prosba o sprawdzenie