열이아빠의 어쨌거나 저쨌거나

8월 5일 codenary라는 사이트를 이제야 알았네요. 각 기업에서 어떤 기술 스택을 사용하는지 알아볼 수 있는 사이트입니다. SK플래닛에서 공유한 글을 보면 기업에서 자료를 제출하면 기술 스택 정보를 제공하는 형식인 듯합니다. https://www.facebook.com/README.SKP/posts/pfbid0xnLkzxkC89nQeWchtmdsWd4WQ5ExNwzvN8b4QaeTvKGNgGKgzkiRZFWR5jQD1Qd7l 문서화 도구 관련해서도 찾아보았는데요. 아무래도 nextjs 같은 도구는 꼭 문서화에만 사용하는 것이 아니라서 꽤 많은 기업에서 사용하고 있습니다. docusaurus 같은 경우에는 1곳에서만 사용한다고 등록을 했구요. https://www.codenary.co.kr/techs..

7월 4일 AWS 일부 문서에는 "기여자(Contributors)" 항목이 있습니다. 테크니컬 라이터뿐 아니라 문서 작성에 관여한 컨설턴트, 엔지니어의 이름이 기록됩니다(주로 백서 성격의 문서인 경우에 항목이 있습니다). 내부적으로는 버전 관리를 하면서 누구누구가 해당 문서를 작성하고 검토했는지 알 수는 있겠지만 이처럼 외부에 문서 작성에 기여한 이들의 이름을 표기하는 방식도 신선하네요. https://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/security-reference-architecture/contributors.html 7월 5일 아마존 웹 서비스의 테크 에반젤리스트 윤석찬 님의 글입니다. 아마존에서의 글쓰기 문화에 대한 이야기는 많이 ..

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일 테크니컬 라이팅 온라인 교육 사이트가 오픈했습니다. 테크니컬 라이팅 교육과 컨설팅 서비스를 제공하는 디앤디에서 카카오 같은 재택 대상 기업에게 제공하기 위한 용도로 시작한 것이 아닌가 싶습니다. 현재는 일반 공개된 교육은 없고 특정..

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..

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일에는 반영된 것을 확인했습니다. 사용자에 따라 다를 수는 있습니다. 메뉴에서 [도구 > 환경설정] 선택하고 옵션에서 "마크다운 자동 감지"를 체크합니다. 그럼 텍스트 입력 시 바로 ..

3월 2일 MDN 사이트가 전반적으로 개편됐습니다. 커뮤니티를 강화하고 접근성과 사용성을 강화했다고 합니다. 오랫동안 익숙했던 사이트라 변화가 막 반갑지는 않네요 ^^ 공룡 로고가 사라진 것도 아쉽고~ https://hacks.mozilla.org/2022/03/a-new-year-a-new-mdn/ 참고로 MDN 사이트가 깃헙 기반으로 변경한 것은 2020년 12월입니다. 아마도 그 당시에는 기능은 유지한 채 소스만 이관하고 일부 수정한 듯하고요. 이번에는 전반적인 사용성 개선을 목적으로 개편이 된 것이고요. https://hacks.mozilla.org/2020/12/welcome-yari-mdn-web-docs-has-a-new-platform/ 3월 15일 5월 22일부터 24일까지 진행될 WTD..

2월 16일 지난주 카카오 엔터프라이즈 블로그에 "스타일 가이드"에 대한 이야기가 올라왔습니다. 개인적으로는 네카라쿠배 정도의 기업에서는 "스타일 가이드"를 구글, 마이크로소프트처럼 외부에 공개하고 1인 테크니컬 라이터 또는 문서를 담당하는 개발자를 위해 도움을 주면 어떨까 싶습니다. 구글 "스타일 가이드"를 참고할 수도 있지만 언어의 차이가 있으니깐요. https://tech.kakaoenterprise.com/133 2월 21일 온라인으로 공개되는 문서는 인쇄물보다는 좀 더 무심할 수 있습니다. 오래된 기술 문서를 찾아보고 그들의 고민과 열정에 귀 기울여 보는 것도 나쁘지는 않겠죠. For all the reasons I’ve just stated above, I think that collectin..

1월 3일 카카오 엔터프라이즈 테크니컬 라이터 팀에서는 꾸준히 테크니컬 라이팅에 도움이 될 수 있는 글을 공유하고 있습니다. 이번에는 트러블슈팅에 관련된 내용입니다. 국내에서는 "문제 해결"로 번역해 사용하고 있습니다. 카카오 같은 경우도 "카카오 로그인 개발자 문서"에서는 "문제 해결"로 메뉴명을 표시하고 있습니다(하지만 위키피디아에서는 "트러블슈팅"과 "문제 해결" 문서가 따로 있습니다. "트러블슈팅"을 "문제 해결"의 일종으로 구분하고 있네요). https://developers.kakao.com/docs/latest/ko/kakaologin/trouble-shooting "...일반적으로 Troubleshooting 가이드는 오류 상황을 나타내는 오류 코드 혹은 오류 메시지, 문제 원인 및 증상,..