본문 바로가기

728x90

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

(37)
2022년 3월 테크니컬 라이팅 이런 저런 소식 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..
2022년 2월 테크니컬 라이팅 이런 저런 소식 2월 16일 지난주 카카오 엔터프라이즈 블로그에 "스타일 가이드"에 대한 이야기가 올라왔습니다. 개인적으로는 네카라쿠배 정도의 기업에서는 "스타일 가이드"를 구글, 마이크로소프트처럼 외부에 공개하고 1인 테크니컬 라이터 또는 문서를 담당하는 개발자를 위해 도움을 주면 어떨까 싶습니다. 구글 "스타일 가이드"를 참고할 수도 있지만 언어의 차이가 있으니깐요. https://tech.kakaoenterprise.com/133 2월 21일 온라인으로 공개되는 문서는 인쇄물보다는 좀 더 무심할 수 있습니다. 오래된 기술 문서를 찾아보고 그들의 고민과 열정에 귀 기울여 보는 것도 나쁘지는 않겠죠. For all the reasons I’ve just stated above, I think that collectin..
2022년 1월 테크니컬 라이팅 이런 저런 소식 1월 3일 카카오 엔터프라이즈 테크니컬 라이터 팀에서는 꾸준히 테크니컬 라이팅에 도움이 될 수 있는 글을 공유하고 있습니다. 이번에는 트러블슈팅에 관련된 내용입니다. 국내에서는 "문제 해결"로 번역해 사용하고 있습니다. 카카오 같은 경우도 "카카오 로그인 개발자 문서"에서는 "문제 해결"로 메뉴명을 표시하고 있습니다(하지만 위키피디아에서는 "트러블슈팅"과 "문제 해결" 문서가 따로 있습니다. "트러블슈팅"을 "문제 해결"의 일종으로 구분하고 있네요). https://developers.kakao.com/docs/latest/ko/kakaologin/trouble-shooting "...일반적으로 Troubleshooting 가이드는 오류 상황을 나타내는 오류 코드 혹은 오류 메시지, 문제 원인 및 증상,..
2021년 11월 테크니컬 라이팅 이런 저런 소식 11월 3일 올해 카카오 컨퍼런스 세션 중 글쓰기에 관한 세션이 있는지 찾아보았습니다. 테크니컬 라이터를 위한 글쓰기는 아니지만 오히려 더 어려운 사용자를 위한 글쓰기 가이드를 만들어낸 경험을 공유하는 세션이더군요(11월 16일 오전에 열리는 세션입니다). https://if.kakao.com/session/66 찾아보니 지난 8월에 카카오 메이커스 브런치를 통해 가이드에 대한 이야기를 공유하고 있었네요. 아마 브런치에 있는 내용이 세션에 담기지 않을까 싶습니다. 브런치 본문에 가이드 문서 PDF 파일을 내려받을 수 있는 링크가 있습니다. https://brunch.co.kr/@makerswithkakao/28 11월 5일 냉장고 소리 이해하기라는 독특한 콘텐츠입니다. 실제 냉장고 소리를 들어볼 수 있고..
2021년 12월 테크니컬 라이팅 이런 저런 소식 12월 10일 GitLab에서 공개한 테크니컬 라이팅 교육 자료입니다. 커뮤니티 기여자를 위한 간단한 교육 자료와 영상입니다(변경 이력을 보면 올해 5월 즈음에 오픈한 듯합니다). 사내 엔지니어를 위한 테크니컬 라이팅 교육 자료를 만들거나 제공할 때 참조하시면 좋을 듯합니다. https://about.gitlab.com/handbook/engineering/ux/technical-writing/fundamentals/ 자료를 보다가 GitLab 테크니컬 라이터, 매니저 Role에 대한 링크를 발견했습니다. 예전에 이런 자료 찾다가 못 찾았는데 잘 정리가 되어 있네요. 채용 프로세스도 설명이 되어 있는데 고객지원부서에서도 인터뷰에 참여한다는 것이 인상적이네요. https://about.gitlab.com/..

반응형