본문 바로가기

728x90

테크니컬 라이팅

(309)
문서 내에서 URL 예시를 보여줄 때 습관적으로 dummy.com 같은 URL을 사용했는데 어떤 식으로 가상의 URL이라고 생각하고 작성해도 누군가 그것을 등록해서 사용했을 때 문제가 될 수 있기 때문에 아무것이나 사용하지 말라고 합니다. 공식적으로 문서 내에서 사용할 수 있는 도메인이 공개가 되어 있습니다. https://www.rfc-editor.org/rfc/rfc6761.html Instead, use one of the web addresses that have been designated by the Internet Assigned Numbers Authority (IANA) exclusively for use in examples. These web addresses are http://www.example.com, http:/..
2024년 4월 테크니컬 라이팅 이런 저런 소식 4월 1일 What's the one word you've used most in your TW career that you never used before it? 래딧 테크니컬 라이팅 채널에 올라온 글입니다. 흥미로운 질문이네요. https://www.reddit.com/r/technicalwriting/comments/1br4onr/whats_the_one_word_youve_used_most_in_your_tw 답변 중에 가장 많은 투표를 받은 단어는 "Select"인데요. "Click"이 아닌 이유는 최근의 기술 문서에서는 접근성(키보드 사용자) 또는 모바일 사용자 모두 적용할 수 있는 단어로 "Select"를 선택한다고 합니다. 그 외에도 여러 코멘트가 있으니 확인해보세요. 4월 3일 AI Th..
WTD 호주 2023 - 라이트닝 토크 모음 Lightning Talk: Alec Clews - One Word Trick to Automate docs as code 보통 클라우드에서 작업할 때는 뭔가 피드백이 늦게 발생합니다(작업 환경에 따라 다르지만). 그래서 Git 클라이언트에서 사용할 수 있는 Git Hook 옵션을 제안합니다. 발표자료: https://docs.google.com/presentation/d/e/2PACX-1vSE_oFHfPPC8SuP0Nqvco6om2kLCX7DUDkKC_pqHdfcY7He7n5IBLPbZmj1yOlzDIJa9a_m6uAruRa1/pub?slide=id.p 데모: https://gitlab.com/alecthegeek/docs-as-code https://youtu.be/K-T0u-nIaOc?si=-JTc..
WTD 호주 2023 - 요즘 업계는 어떤가요? 이전에는 발표자 2-3명이 Q&A를 하는 형식이었는데 이번에는 Q&A는 각각 진행하고 패널 토의 형식의 새로운 세션이 만들어졌습니다. 2명은 발표를 하신 분이고 1명은 게스트로 초대를 했다고 하네요. 제목처럼 "Tech comms today" 업계 동향을 이야기하는 세션이었는데 어쩌다 보니 그냥 일반적인 이야기로 흘러간 것 같습니다. * 요즘 업계는 어떤가요? 궁금하다면 래딧을 참고하세요. 주로 북미 쪽 이야기가 많긴 하지만 최근 업계가 어떤지 참고할 수 있습니다. 주로 나쁜(?) 이야기가 많은데 좋은 이야기는 보통 이런 커뮤니티에서 하지 않아서 ^^ 불만 그런 것이 많습니다. https://www.reddit.com/r/technicalwriting/ Sarah Maddox 2024.01.23 - [테..
2024년 3월 테크니컬 라이팅 이런 저런 소식 3월 4일 내가 사용하는 맞춤법 검사기는? 2월 23일 맞춤법 검사기에 대한 동영상을 올리면서 진행한 설문입니다(지난달에 올린다고 하는 것을 잊어버리고 3월 첫 소식인 것처럼 ㅠㅠ) https://youtu.be/cDwcUKslhHQ?si=ptn9ytGEcfL-Z3DU 네이버가 80%로 1위, 부산대 맞춤법 검사기가 15%로 2위네요. 다음은 1%. 네이버 맞춤법 검사기는 의외로 사용성이 좋지 않은데도 다음과 비교가 되지 않는군요 ㅠㅠ https://www.youtube.com/post/UgkxRNAeasOal82GqkRToxSXY_NWUxTWETXF A NEW CHAPTER FOR A BOOK APART https://abookapart.com/blogs/press/a-new-chapter-for-a-..
WTD 호주 2023 - 거절에 대처하는 방법 바다 건너 일하는 친구들은 해고에 대해서 그렇게 심각하게 받아들이지 않는다고 이야기하지만(한국에 비해서) 꼭 그런 것은 아닌가 봅니다. 어찌 되었든 해고라는 것은 거절의 다른 표현이기 때문에 누구나 맘이 편한 것은 아닙니다. 발표자 또는 그들의 지인이 겪은 인터뷰, 채용, 해고 등에 대한 이야기를 전달합니다. 그중 흥미로운 에피소드는 테크니컬 라이터 정규직으로 지원했는데 작문 능력이 떨어진다고 피드백을 받으면서 거절당했습니다. 하지만 얼마 후 같은 회사에 계약직으로 일하게 되었고 작문 능력이 뛰어나다며 정규직 제안을 받았다고 합니다. ATS에 대한 이야기도 흥미롭네요. 아마 규모가 어느 정도 있는 회사의 이야기겠지만 적절한 키워드가 포함되어야 하고 기회가 된다면 이력서를 수정해서 다시 지원해야 합니다. ..
WTD 호주 2023 - 스타트업에서는 모든 것을 다 해볼 수 있을까? 이전에는 주로 규모가 있는 기업에서 계약직 또는 정규직으로 일하다가 스타트업에서 일할 기회가 생겨서 합류했다고 합니다. 스타트업에서는 이전에 하고 싶었지만 하지 못했던 이런저런 일들을 좀 더 자유롭게 할 수 있을 것이라 기대했습니다. 하지만 예산 문제, 의사 결정의 책임 문제 등으로 인한 현실에 맞닿게 됐습니다. 다른 세션에 비해 짧은 시간 진행했지만 분위기도 좋고 Q&A 세션도 반응이 좋네요. 다만 하고자 하는 이야기가 어떤 것인지 포인트는 잘 잡지 못하겠네요 ㅠㅠ 파이에 대한 비유는 humble pie 라는 표현으로 겸손하게 행동하다는 의미라고 합니다. 스타트업에서는 내가 중요한 결정을 내리는 경우가 많은데 항상 최선의 결정을 내릴 수는 없다는 것입니다. 그래서 이를 인정하고 겸손한 마음을 가져야 한..
WTD 호주 2023 - 박물관에도 테크니컬 라이터가 있나요? 독특하게 박물관에서 일하는 테크니컬 라이터라고 합니다. 한국에서는 제조 또는 IT 분야에서만 테크니컬 라이터를 생각하는데 다양한 분야에서 테크니컬 라이터가 일하고 있는 것을 알 수 있습니다. 테크니컬 라이터가 되기 위한 경로가 그만큼 많은 것이죠. 박물관에서 테크니컬 라이터는 전시물을 분류하고 이에 대한 기록을 남기고 데이터를 관리하는 등의 일을 한다고 합니다. 그래서 하는 일은 일반적인 테크니컬 라이터가 하는 일과 크게 다르지 않습니다. 감사(Audit) - 작업 대상을 선별하고 우선순위를 정하세요. - 감사 도중에 바로 고칠 수도 있지만 작업은 나중에 하세요. 그렇지 않으면 감사 작업을 마치지 못할 겁니다. 컨트롤(Control) 이 부분은 3가지를 왜 비교해서 설명하는지 잘 이해가~ 뭐 하여간 어떤..

반응형