본문 바로가기

728x90

테크니컬 라이팅

(310)
2023년 5월 테크니컬 라이팅 이런 저런 소식 5월 7일 WTD 포틀랜드 2023 행사가 7일부터 9일까지 진행됩니다. 오랜만에 오프라인, 온라인 동시에 진행되는 행사입니다. WTD 슬랙에 행사 사진들도 슬슬 올라오고 있구요. 각 세션 영상은 행사가 끝나면 공유될 예정입니다. 어떤 분위기일지 궁금하네요. https://www.writethedocs.org/conf/portland/2023/ Home | Write the docs Portland 2023 Welcome to Write the Docs Portland 2023- May 01, 2023, Write the Docs
WTD 호주 2022 요약 - 라이트닝 토크 모음 Cameron Shorter - My Open Source Docs Addiction https://youtu.be/S-6NxPUorgU 오픈소스에 참여하면 얻을 수 있는 것들 - 영향력을 넓힐 수 있습니다. - 아무도 여러분을 방해하지 않습니다. 원하는 걸 다 해볼 수 있죠. - 커뮤니티에 참여하면서 다양한 경험을 할 수 있습니다. 뭐 물론 오픈소스 커뮤니티라고 해서 다 깔끔한 건 아닙니다. 심지어는 정치적인 다툼도 있구요. 뭔가 발표가 어설퍼보이지만 이 분은 구글 테크니컬 라이터이면서 제품 관리자입니다. 구글에는 2020년 합류했고 그 이전에는 다양한 기업에서 엔지니어, 테크니컬 라이터로 일했습니다. 1987년에 학위 과정을 시작했으니 대략 50대 중반이시겠네요. Gaurav Nelson - Unlo..
WTD 호주 2022 - PLG 전략과 기술 문서 Alex Fiedler는 Torq라는 사이버 보안 플랫폼 기업에서 지식 경험 부문을 담당하고 있습니다. PLG는 Product-Led Growth의 약자라고 합니다. 우리말로 번역하면 제품주도성장이라는 의미라고 합니다. Wes Bush의 책 "Product-Led Growth: How to Build a Product That Sells Itself"에서 시작된 표현이라고 하네요. 2019년에 나온 책인데 이 책이 번역되지 않은 것은 좀 신기하네요. https://productled.com/book 에서 온라인으로 내용을 볼 수는 있습니다. PLG 전략이 새로운 것은 아니지만 최근 테크 기업에서 많은 관심을 받고 있고 그 영향력을 넓혀가고 있습니다. 지식 경험이라는 표현은 좀 낯설 수 있는데요. 지식은 ..
2023년 4월 테크니컬 라이팅 이런 저런 소식 4월 3일 "Docs for Developers 기술 문서 작성 완벽 가이드"가 4월 10일 출간 예정이라고 합니다. 부록으로 "국내 유명 테크니컬 라이터 11인의 인터뷰가 수록"됐다고 하네요. 원서 제목은 "Docs for Developers: An Engineer’s Field Guide to Technical Writing"입니다. https://www.hanbit.co.kr/store/books/look.php?p_code=B8810771470 Docs for Developers 기술 문서 작성 완벽 가이드 소프트웨어 개발자를 안내하는 테크니컬 라이팅을 위한 실무 노트 우아한형제들, 카카오, AWS, LINE Plus, 쿠팡, NHN, 데브시스터즈, 넷마블 등 국내 테크니컬 라이터 11인 인터뷰 ..
2023년 3월 테크니컬 라이팅 이런 저런 소식 3월 7일 reddit에 "what is 'cool' about being a technical writer?"라는 질문이 올라왔습니다. 뭐 좋은 답변도 많은데 가슴 아픈 이야기도 많네요. - The fact that I've been doing this for three years and still nobody from my family and most of my friends don't understand what I'm doing. - My mom thought I've been working at a call center for the past 8 years, regardless of all my job and career changes I've told her about. - Barely any..
당구장 표시에 대해 위키백과에서는 "참고표"라고 이름을 붙였습니다. 해당 기호의 유니코드 이름이 "Reference Mark"인데 이를 번역한 것으로 보입니다. 한국과 일본에서만 사용한다고 합니다. 한국에서 이를 "당구장 표시"라고 부르는 것처럼 일본에서는 "こめじるし、米印"라고 부릅니다. 위키백과에서는 "참고표(參考標, reference mark)는 다음 내용을 참고하라는 의미로 사용하는 문장 부호이다."로 설명하며 문장 부호라고 하는데 국립국어원에서 규정한 문장 부호에는 해당 기호가 포함되지 않았습니다. 관련 질문에 대한 답변에서도 문장 부호가 아니기 때문에 답을 할 수 없다고 합니다. https://www.korean.go.kr/front/onlineQna/onlineQnaView.do?mn_id=216&qna_seq..
WTD 호주 2022 - 처음 인터뷰어로 참여하는 이들을 위한 팁 Ishara Ilangasinghe는 개발자로 경력을 시작했고 테크니컬 라이팅 업무에 관심을 가지고 현재는 테크니컬 라이터로서 일하고 있다고 합니다. WSO2라는 오픈소스 API 관리 플랫폼을 개발하는 기업에서 테크니컬 라이터로 일하고 있습니다. 테크니컬 라이터 지원자를 인터뷰하는 인터뷰어로서 첫 경험을 공유합니다. 첫 인터뷰를 준비하면서 인터뷰어의 관점에서 자료를 찾아보았지만 정보가 거의 없었다고 합니다. 인터뷰이 관점에서 인터뷰를 준비하기 위한 리소스는 많지만 그 반대는 찾기 힘들다는 것입니다. * 테크니컬 라이터 지원자를 위한 인터뷰라는 제목이지만 딱히 테크니컬 라이터 지원자가 아니더라도 적용할만한 내용입니다. 그렇게 보면 리소스가 그리 적지는 않을 텐데 말이죠. 인터뷰 준비 1. 이력서 검토하기 ..
ISO/IEC 15910-2002는 무슨 문서일까요? 아래 내용에서 '표준'의 출처는 'ISO/IEC 15910-2002'라고 합니다. 하지만 ISO 표준 문서에는 15910-2002라는 문서는 없습니다. 15910-1999가 마지막이고 그 이후에는 26512가 이를 대체합니다. ISO/IEC 표준에 따르면 문서 한 페이지의 초안을 작성하는 데 1시간이 소요된다고 합니다. ISO 표준에 따르면, 페이지당 내용 리뷰에는 30분, 단순 교정 작업에는 약 15분이 소요됩니다. 2023년 기준 26512:2018 문서가 최종이네요. https://www.iso.org/standard/72088.html ISO/IEC/IEEE 26512:2018 Systems and software engineering — Requirements for acquirers and s..

반응형