본문 바로가기

728x90

테크니컬 라이팅/이런 저런 소식

(37)
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일 '서비스의 기술 문서를 책임지는 테크니컬 라이터'라는 주제로 카카오 엔터프라이즈 인턴 이해영 님이 발표한..
2022년 10월 테크니컬 라이팅 이런 저런 소식 10월 4일 bytebase라는 스타트업에서 이용하는 SaaS 서비스 중 가장 많은 비용을 지출하는 것이 grammarly 라고 합니다. 월 200달러를 지출하는데 연간 플랜으로 40% 할인받고 대략 13-14명이 사용하는 듯합니다. https://www.grammarly.com/upgrade/business/try https://www.bytebase.com/jobs 에서 엔지니어링 인턴을 뽑고 있는데 선발 과정의 마지막 단계에 기술 작문 단계가 있습니다. 뭔가 글쓰기에 진심인 회사가 아닌가 싶네요. https://news.hada.io/topic?id=7534 10월 7일 지난주 목요일(9월 29일) 진행했던 라인 밋업 영상입니다. 3개의 영상이 차례로 공개됐습니다. https://youtu.be/9..
2022년 9월 테크니컬 라이팅 이런 저런 소식 9월 2일 postman에서 사용자를 대상으로 진행한 설문 결과입니다. 올해는 6월부터 7월까지 진행하고 8월 중순에 결과를 공개했습니다. 개발자들이 API를 사용하는 비중이 2020년 40%에서 2022년 51%로 늘어났고 경기는 불안하지만 API에 대한 투자는 늘어날 것으로 예측하고 있습니다. 문서화 관련된 몇몇 수치가 있는데 그중 "Improving API documentation"의 결과가 살짝 달라졌습니다. 2020, 2021년에는 Better examples, Sample code에 대한 요구가 많았는데 2022년에는 Up-to-date documentation이 1위를 차지했습니다. API가 만들어지고 사용하는 일이 많아지면서 그에 대한 적절한 문서화가 동반되지 못한 결과가 아닌가 싶네요. ..
2022년 8월 테크니컬 라이팅 이런 저런 소식 8월 5일 codenary라는 사이트를 이제야 알았네요. 각 기업에서 어떤 기술 스택을 사용하는지 알아볼 수 있는 사이트입니다. SK플래닛에서 공유한 글을 보면 기업에서 자료를 제출하면 기술 스택 정보를 제공하는 형식인 듯합니다. https://www.facebook.com/README.SKP/posts/pfbid0xnLkzxkC89nQeWchtmdsWd4WQ5ExNwzvN8b4QaeTvKGNgGKgzkiRZFWR5jQD1Qd7l 문서화 도구 관련해서도 찾아보았는데요. 아무래도 nextjs 같은 도구는 꼭 문서화에만 사용하는 것이 아니라서 꽤 많은 기업에서 사용하고 있습니다. docusaurus 같은 경우에는 1곳에서만 사용한다고 등록을 했구요. https://www.codenary.co.kr/techs..
2022년 7월 테크니컬 라이팅 이런 저런 소식 7월 4일 AWS 일부 문서에는 "기여자(Contributors)" 항목이 있습니다. 테크니컬 라이터뿐 아니라 문서 작성에 관여한 컨설턴트, 엔지니어의 이름이 기록됩니다(주로 백서 성격의 문서인 경우에 항목이 있습니다). 내부적으로는 버전 관리를 하면서 누구누구가 해당 문서를 작성하고 검토했는지 알 수는 있겠지만 이처럼 외부에 문서 작성에 기여한 이들의 이름을 표기하는 방식도 신선하네요. https://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/security-reference-architecture/contributors.html 7월 5일 아마존 웹 서비스의 테크 에반젤리스트 윤석찬 님의 글입니다. 아마존에서의 글쓰기 문화에 대한 이야기는 많이 ..
2022년 6월 테크니컬 라이팅 이런 저런 소식 6월 3일 Write the Docs Portland 2022 동영상이 공개됐습니다. 12개 세션, 10개의 lightning talk 영상이 포함되어 있습니다. https://www.youtube.com/playlist?list=PLZAeFn6dfHpnDhFvXG8GprqlLlzSQRBui https://www.writethedocs.org/conf/portland/2022/news/thanks-recap/ 에서 그 외 컨퍼런스 관련 정보를 확인하실 수 있습니다. 6월 8일 테크니컬 라이팅 온라인 교육 사이트가 오픈했습니다. 테크니컬 라이팅 교육과 컨설팅 서비스를 제공하는 디앤디에서 카카오 같은 재택 대상 기업에게 제공하기 위한 용도로 시작한 것이 아닌가 싶습니다. 현재는 일반 공개된 교육은 없고 특정..
2022년 5월 테크니컬 라이팅 이런 저런 소식 5월 4일 디앤디에서 진행하는 'B2B 국문 테크니컬 커뮤니케이션 공개 교육' 안내입니다. 6월 2일 하루 진행되는 교육이구요. 오랜만에 오프라인으로 진행됩니다. 'B2B'라는 문구는 크게 신경 쓰지 않아도 됩니다. B2B 국문 테크니컬 커뮤니케이션 공개 교육 비슷한 내용으로 TTA에서 6월 20일부터 3일간 테크니컬 라이팅 교육이 진행될 예정입니다(이건 5월 23일부터 등록이네요). 강사가 같은지는 모르겠습니다. 예전에는 장현아 대표가 직접 진행했는데 요즘에는 다른 강사를 보내기도 하더라구요. 2022년 제1차 SW 글로벌화를 위한 국‧영문 B2B 테크니컬 라이팅 교육 5월 11일 어제(5/10) 출간된 신간 소개입니다. '구글 엔지니어는 이렇게 일한다 Software Engineering at Goo..
2022년 4월 테크니컬 라이팅 이런 저런 소식 4월 1일 구글 문서에서 마크다운을 일부 인식하고 처리하는 기능을 추가했습니다. 옵션으로 선택할 수 있고 해당 기능은 3월 29일부터 점차적으로(구글 워크스페이스 사용자 기준이긴 합니다만) 반영된다고 합니다. https://support.google.com/docs/answer/12014036 https://workspaceupdates.googleblog.com/2022/03/compose-with-markdown-in-google-docs-on.html?m=1 이 글을 처음 쓴 4월 1일에는 아직 반영이 되지 않았는데 6일에는 반영된 것을 확인했습니다. 사용자에 따라 다를 수는 있습니다. 메뉴에서 [도구 > 환경설정] 선택하고 옵션에서 "마크다운 자동 감지"를 체크합니다. 그럼 텍스트 입력 시 바로 ..

반응형