본문 바로가기

728x90

테크니컬 라이팅

(309)
테크니컬 라이터를 위한 Udemy 강의 추천 - Learn API Technical Writing: JSON and XML for Writers 부제는 "API Documentation 1: Teaches technical writers how to document structured data. No programming experience required."입니다. 프로그래밍 경험이 전혀 없는 테크니컬 라이터에게 API가 무엇이고 왜 사용하는지. 구조적 데이터가 무엇이고 JSON, XML이 무엇인지 아주 간략하게 설명합니다. 그리고 구조적 데이터를 가지고 간단한 문서를 만드는 과정까지 진행합니다. Swagger나 XSD 같은 용어가 등장하긴 하지만 구체적으로 어떻게 다루는 것인지 알려주지는 않습니다. 그냥 이런 것이 있다 정도로만 언급하고 필요하면 관련 과정을 수강하세요. 그런 느낌입니다. 강사는 Peter Gruenbaum이고 SDK Brid..
테크니컬 라이터를 위한 Udemy 강의 추천 - Technical Writing: How to Write Software Documentation 부제는 'Learn a proven strategy for writing software docu in GitHub wiki based on the 12 main principles of technical writing!'입니다. 최근 일부 강의를 업데이트하면서 DITA 대신 마크다운으로 실습하는 것으로 내용이 수정됐습니다. 2019년과 2023년의 배울 내용을 비교해 보면 살짝 달라진 부분을 확인할 수 있습니다. 강사는 Jordan Stanchev 이지만 'JPDocu School of Technical Writing'이라는 이름으로 강의는 올라옵니다. JPDocu School의 실제 강사는 혼자 하는 거라서 그냥 뭔가 이름만 걸고 있는 것이 아닌가 싶습니다. Jordan Stanchev는 테크니컬 라..
테크니컬 라이터를 위한 Udemy 강의 추천 - 개발자영어 강의 제목은 '개발자영어'지만 이걸 학습했다고 해서 외국계 회사에 취업할 수 있는 건 아닙니다. 아주 아주 조금은 도움이 될 수 있겠지만 이 강의는 그런 강의는 아닙니다. 영어 자체보다는 개발자에게 영어가 왜 필요하고 어떨 때 영어를 사용하는지 알려주는 가이드라고 설명하는 것이 좀 더 적절할 것 같습니다. 때문에 개발자뿐 아니라 테크니컬 라이터 특히 개발자 출신이 아닌 테크니컬 라이터가 IT 기업에서 개발자들과 함께 일하는 경우에 추천해 드리는 강의입니다. 개발자가 어떤 식으로 정보를 찾고 커뮤니케이션하는지 살짝 들여다볼 수 있기 때문이죠. 5개의 섹션으로 구분되어 있고 수시로 보충 자료를 업데이트하고 있습니다. 섹션 1: 왜 영어가 필요한지 어떤 부분에 집중해서 학습해야 하는지 설명합니다. 말하기보다는..
WTD 호주 2022 - 짧은 시간 내에 뒤죽박죽 문서 관리 해결하기 Claire Mahoney는 테크니컬 라이터로 경력을 시작해서 Atlassian 등의 회사와 프리랜서 컨설턴트 경력을 거치면서 현재는 Kinde(그 이북 킨들 아니고 인증 관련 서비스를 제공하는 기업이라고 하네요)라는 회사에서 UX 콘텐츠 라이터로 일하고 있습니다. 발표할 대상의 기업명은 밝히지 못하지만 대략적인 규모는 이야기할 수 있다고 합니다(컨설팅을 해준 건지 계약직으로 일한 건지는 모르겠습니다. 결론부터 이야기하면 문제를 잘 해결하고 회사를 떠났다고 합니다). 이커머스 관련 기업이여 8년차 정도이고 약 150명이 일하고 있으며 빠르게 설정하는 조직이었습니다. 문서 기준으로 350~400개 정도의 문서가 있었다고 합니다. 문서 관리를 위해 zendesk를 사용하고 있었구요. 하지만 몇몇 사소한 이슈..
WTD 호주 2022 - 구글에서 많은 이들이 문서를 찾을 수 있게 하기 Braden Riggs는 2020년 5월 돌비에서 출시한 API 플랫폼 Dolby.io의 개발자 애드보케이트이면서 데이터 과학자로 일하고 있습니다. 영상 첫 번째 타이틀 상단에 돌비 로고가 새겨져 있어서 마치 돌비 사운드 기술을 사용한 것처럼 보입니다. 뭐 마이크는 좋은 것을 사용하는지 소리는 깔끔하긴 합니다. 개발자 애드보케이트 팀에서 일하면서 플랫폼을 개발자 커뮤니티에 알리려는 노력에 집중하며 커뮤니티와 많은 대화를 가졌는데요. 돌비라는 제품 특성 상 개발자들이 검색했을 때 원하는 결과를 얻기가 쉽지 않았다고 합니다. 그냥 "Dolby"라고 검색하기 때문이죠. 일반적으로 온라인 문서를 기획할 때 제품 페이지로 들어와서 문서 랜딩 페이지를 찾고 문서를 찾을 것이라 생각하지만 실제 사용자는 구글에서 검색..
2023년 1월 테크니컬 라이팅 이런 저런 소식 1월 2일 TCN 커뮤니티에서 진행하는 밋업 소식입니다. 2월 온라인으로 진행할 예정입니다. 저도 정확한 히스토리는 잘 모르지만 2009년 오프라인 세미나 이후 오랜만에 TCN에서 진행하는 행사가 되는 것 같네요. https://meetup.techcomnet.kr/2023-02 TCN meetup 2023.02 meetup.techcomnet.kr 1월 16일 AWS 윤석찬 테크 에반젤리스트가 Jeff Barr 부사장의 "Leadership Principles for AWS News Bloggers"이라는 글을 번역하고 자신의 경험을 더해 쓴 글입니다. https://channy.creation.net/blog/1758 블로거 리더쉽 원칙 :: Channy's Blog 차니 블로그(Channy Blog..
2022년 12월 테크니컬 라이팅 이런 저런 소식 12월 1일 한국형 무크(http://www.kmooc.kr/)에서 글로벌 무크 강의 수강을 지원합니다. 대상은 udemy와 Coursera이구요. 둘 다 신청할 수 있습니다(선착순입니다. 아마 예산이 정해져있고 예산 내에서 집행하는 듯합니다). 테크니컬 라이팅 강좌는 udemy에 좀 더 많이 준비되어 있죠. 아래 링크 안내를 따라 신청하면 SMS로 초대 링크가 날라오구요(저는 어제 저녁에 신청했는데 오늘 아침에 받았습니다. 바로 처리되는 건 아니고 뭔가 사람이 확인하는 듯합니다). 초대 링크 안내에 따라 기존 계정 연결 또는 가입하시면 이용할 수 있습니다. udemy가 요즘 이벤트 기간이라 90% 할인 막 이런 거 하는데 그래도 강의당 19,000원 정도이니 이런 기회를 이용하는 것도 좋을 듯합니다. ..
2022년 11월 테크니컬 라이팅 이런 저런 소식 11월 7일 WTD 2023년 컨퍼런스 일정이 공개됐습니다. 포틀랜드 행사는 오프라인으로 5월 7일부터 9일까지 열리고 WriteTheDocs 애틀랜틱이라는 이름으로 9월 10일부터 12일까지 온라인 이벤트가 진행됩니다. WriteTheDocs 애틀랜틱 행사는 미국 동부 기준으로 오전에 시작한다고 합니다. 한국과는 대략 14시간 정도 차이네요. 포틀랜드까지 오기 어려운 미국 동부 지역과 유럽 등 시간대를 고려한 듯합니다. https://www.writethedocs.org/blog/2023-conference-announcements/ 중앙대학교 비전공자 코딩 커뮤니티 COSADAMA에서 11월 2일 '서비스의 기술 문서를 책임지는 테크니컬 라이터'라는 주제로 카카오 엔터프라이즈 인턴 이해영 님이 발표한..

반응형