전체 글 (2663) 썸네일형 리스트형 WTD 베를린 2025 - 라이트닝 토크 둘째 날 Comedy and technical writing - Adrian Doonan 발표자는 2019년(아마 이전에는 PM)부터 테크니컬 라이터를 시작했고 즉흥연기(Improvisation/Improv)도 비슷한 시기에 시작했다고 합니다. 아마 스탠드업 코미디 비슷한 것을 하는 것 같은데 즉흥연기와 테크니컬 라이팅의 비슷한 부분에 대한 이야기입니다. 1. 너무 어렵게 고민하지 말고 쓰세요. 뭔가 떠오르면 그대로 쓰고 당장 떠오르지 않는 것을 고민하지 마세요. 2. (note에 대한 이야기였는데 어떤 의미인지 모르겠네요 ㅠㅠ) 3. 상대방의 이야기를 경청하세요. 즉흥연기에서는 상대방의 연기에 맞추어 주는 것이 중요한데, 테크니컬 라이터도 개발자나 누군가와 이야기할 때 그들의 이야기를 듣고 적절하게 반응해 주.. Hello Word Ping Pong Electron 튜토리얼을 따라가고 있습니다. 요즘은 그냥 AI의 도움을 받아서 개발(?)할 수도 있지만, 고전적인 방법을 선택하고 있습니다.https://www.electronjs.org/docs/latest/tutorial/tutorial-preload#communicating-between-processes 아직은 시작 단계라 큰 어려움 없이 따라가고 있었는데 Communicating between processes라는 단계에서 지정한 텍스트("pong")가 표시되지 않고 있습니다. 혹, 코드 실수가 있었나 살펴보긴 했는데, 코드 실수는 아닌 것 같구요. 이것저것 살펴보다가 결국에는 ChatGPT에게 물어보았습니다. 몇 가지 케이스를 제시해주고 있는데 가장 흔한 실수(라기보다는 개념을 몰라서)가 콘.. Node.js 다운로드 페이지 노트북을 교체하고 나서 Node.js를 당장 쓸 일이 없어서 설치하지 않고 있다가 이런저런 일로 설치할 일이 생겨서 다운로드 페이지에 방문했습니다.https://nodejs.org/ko/download 보통은 다양한 설치 환경에 맞는 파일을 나열하는 방식인데, Node.js는 꽤 깔끔한 방법으로 페이지를 구성했습니다.쉘 환경에서 바로 사용할 수 있는 스크립트를 복사해서 가져갈 수 있게 해놓았고(아마 이건 페이지를 실행한 환경에 가장 최적화된 것을 우선 보여주고 나머지를 선택할 수 있는 방식일 겁니다).그리고 설치 파일을 내려받는 항목을 표시(이것 역시 원하는 환경에 맞는 파일만 딱)합니다. 이렇게 구성하면 지원하는 환경이 늘어나더라도 수정 없이 다운로드 정보를 제공할 수 있을 것 같네요. 아카이브를 찾아.. WTD 베를린 2025 - 라이트닝 토크 첫째 날 5개의 주제로 라이트닝 토크를 진행합니다. 예전에는 라이트닝 토크를 한 개씩 따로 올렸는데, 요즘에는 그냥 영상 하나로 올리고 있습니다. How to win over someone else’s users (with docs) - Jill Osborne 미국 소프트웨어 회사 Imply(임플라이)의 테크니컬 라이터입니다. 국내에서도 당근마켓 등에서 데이터 분석, 시각화를 위한 도구로 사용한다고 합니다. Lumi라는 이름의 새로운 제품을 출시했는데, 이 제품의 주요 타깃은 기존에 Splunk를 사용하는 대상이었고, 때문에 제품에 대한 문서가 바닥부터 설명하는 것이 아니라 해당 타깃 독자에 맞추어 작성되어야 함을 의미합니다(발표자의 표현에 따르면 자연스럽게 다음 단계처럼 느껴지게 만들었어야 했다고 합니다). I.. WTD 베를린 2025 - 팀 리더로서 개인적인 경험 공유 Kat Stoica Ostenfeld는 에픽 게임즈의 테크니컬 라이터입니다. 링크드인의 현재 역할 소개를 보면 큰 규모의 팀 리더를 맡고 있습니다. 어느 정도 규모인지는 알 수 없지만, 현재는 문서 작성 업무를 거의 하지 않는다고 하는 걸 보면 매니저 역할만으로 벅찬 규모일 것 같네요....Leading a large team of documentarians that create learning material, documentation, and development content for the Epic Games engine ecosystem; Unreal Engine, UEFN, and Fortnite Creative...영상에서는 리더가 되면서 느낀 개인적인 경험을 공유합니다. 딱 문서팀이라서 겪는.. 2026년 3월 테크니컬 라이팅 이런 저런 소식 3월 3일사쿠라는 설명을 잘하고 싶어!咲良は上手に説明したい！아직 한국어 번역 일정은 없는 책입니다. 저도 에이전시 인스타에서 책 소개를 보고 알았거든요.저자인 타키자와 시로(滝沢 志郎)의 이전 작품이 소설이길래, 소설가에게 의뢰해서 쓴 작품인가 했는데, 현직 테크니컬 라이터로 일하면서 이 책을 쓴 것이라고 합니다. 아직 따끈따끈한 책이라 리뷰는 많지 않습니다.아래는 에이전시 책 소개입니다.https://www.instagram.com/shinwon.agency/p/DVNErj7CetH/...태풍으로 각 선로가 멈춰 혼란에 빠진 요코하마역. 승객 대응에 쫓기는 아르바이트 역무원 이시카와 사쿠라의 앞에 한 여성——아사쿠라 히비키가 나타난다. 아사쿠라의 매우 알아듣기 쉬운 설명을 듣고 승객들이 납득하는 모습에.. WTD 베를린 2025 - 템플릿 문서 기반 자동화 테스트 조직의 규모가 커지고 제품의 범위가 넓어지면서 사용자 입장에서 딱 원하는 답을 찾기가 점점 어려워졌습니다. 그래서 기존 문서의 문제점을 분석하고 다른 조직의 문서를 검토하면서 How-to 형식의 문서와 튜토리얼 형식의 문서를 통합한 형식을 결정했습니다. 사용자가 원하는 문제를 찾아서 문서에 도달했을 때 아래와 같은 정보를 얻을 수 있습니다. - Prerequisites (바닥부터 문제를 해결해 나갑니다) - Copy/Paste steps (모든 코드는 복사해 바로 적용할 수 있습니다) - Trouble Shooting (트러블슈팅이나 FAQ 정보를 분리하지 않고 같은 페이지 내에서 확인할 수 있습니다) 이와 같은 형식으로 템플릿을 만들고 개발자 그룹에서 템플릿을 채우는 형식으로 검증 과정을 진행했습니다... WTD 베를린 2025 - Write the Docs의 우연한 시작에 대해 WTD 포틀랜드 행사가 열리기 얼마 전에 STC가 파산 선언을 하고 문을 닫았습니다. 포틀랜드 행사에 STC에서 활동하던 이들이 몇몇 참여했는데, 여러 가지로 힘들었는데 이곳에 와서 환영을 받고 기운을 얻었다고 합니다. 그리고 WTD 슬랙 하드웨어 채널이 이전에 비해 상당히 활발해지기 시작했다고 합니다(아무래도 WTD는 소프트웨어 위주의 운영이었긴 합니다). 포틀랜드 행사에서 하드웨어(의료기기) 관련 테크니컬 라이터의 발표도 이전과 비교해 보면 상당히 새로운 것이었다고 합니다.2025.05.27 - [테크니컬 라이팅/컨퍼런스] - WTD 포틀랜드 2025 - 규제가 문서화에 미치는 영향발표자인 Jennifer Rondeau는 역사학으로 박사 과정을 마치고 어찌어찌하다가 테크니컬 라이팅 업계에 발을 들여놓.. 이전 1 2 3 4 ··· 333 다음
