본문 바로가기
728x90

분류 전체보기

 (2533)
WTD 프라하 2022 - 마케팅팀과 문서팀이 사이좋게 지낼 수 있을까요 Mano Toth는 오스트리아의 PSPDFKit라는 PDF 솔루션 기업에서 테크니컬 라이터로 일하고 있습니다. 독특하게 케임브리지에서 박사 학위를 받았는데 테크니컬 라이터로 일하고 있습니다. 주제가 마케팅으로서의 문서화인데, 문서 특히 기술 문서에서는 마케팅적인 요소를 가능한 배제합니다. 마케팅은 사실과 완전히 다르지는 않지만 뭔가 사람들을 혹하게 하는 문구들을 사용하는데 그런 부분들 때문에 테크니컬 라이터는 마케팅과 어느 정도 거리를 두고 있습니다(하지만 이건 그럴 것이다라고 대부분의 사람들의 머릿속에 있는 것이죠). Mano는 마케팅과 문서가 서로 갈등 관계에 있다는 증거 중 하나가 대부분의 기술 기업 웹사이트가 문서 사이트와 통합되지 않았다는 겁니다. 기업 웹사이트는 화려하고 SEO를 적용한 반면 ..
WTD 프라하 2022 - 밑바닥에서부터 문서팀 만들기 Karissa Van Baulen은 웹사이트 분석 소프트웨어를 만드는 Hotjar에서 기술지원, 콘텐츠 개발, 사용자 교육 등의 업무를 담당하고 있습니다. 현재는 사용자 교육팀 리더라고 합니다. 테크니컬 라이터로 일한 것은 대략 5년 정도 되었구요. 2017년에는 지원팀 전체가 7명이었고 관리하는 문서는 107개였다고 합니다. 이 때는 문서의 소유자가 명확하지 않아서 문서 유지 관리가 제대로 되지 않았던 시기였습니다. Karissa가 기술지원 조직으로 입사를 한 것이 2017년 4월이었는데 이런 상황을 참지 못하고 문서 담당자가 되기로 했다고 합니다. 그 이전 경력을 보면 디자이너, 제품 매니저 등의 업무를 담당했지만 테크니컬 라이터로서 일한 적은 없습니다. 좀 독특한 케이스네요. 그런 결심을 하고 당연..
교보 이북 도서관 DRM 오류 이북을 내려받아 보려 했는데 책을 다 내려받고 실행 단계에서 계속 아래와 같은 DRM 오류가 발생합니다. 해당 오류 코드(0x304)로 찾아보면 재설치를 하거나 기술지원 쪽에 문의하라고 합니다. 일단 재설치(이북 도서관, DRM 클라이언트)를 해보았지만 여전히 실행이 되지 않습니다. 혹시나 하고 피들러를 실행해보았습니다. 이북 실행 시에는 이북 파일(epub)을 내려받고 교보 쪽 인증 서버에 확인을 요청하는 작업을 진행합니다. 아래에서 3번째 라인부터네요. 그런데 해당 요청에 대한 응답이 오지 않습니다. 해당 요청이 원래 응답이 없는 건지 피들러에서 해당 응답을 체크하지 못하는 건지는 모르겠으나 뭔가 이상이 있는 듯합니다. Q&A에서도 해당 서버 오류를 언급하는 내용들도 있었거든요. 일단 내일 다시 한번..
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가 만들어지고 사용하는 일이 많아지면서 그에 대한 적절한 문서화가 동반되지 못한 결과가 아닌가 싶네요. ..
WTD 프라하 2022 - 문서화를 가로막는 6가지 것들 Emilia Juda Özbay는 블룸버그 테크놀로지 엔지니어입니다. 사내 개발자를 위한 개발도구를 만들거나 지원하는 업무를 담당하고 있어 문서화 도구도 마찬가지입니다. 블룸버그 테크놀로지에서 기존 자바스크립트 기반 환경을 타입스크립트로 변경하기로 결정했습니다. 코드 전환은 물론 배포 환경까지 바뀌어야 하는 커다란 인프라 변경이었지요. 이왕 바꾸는 김에 문서화 시스템도 같이 변경하기로 하고 현재 시스템의 pain point 6가지를 조사합니다. (정확하게는 조사한 건 아니고 이런 저런 자료들을 참고해서 6가지를 선정한 것 같습니다. 참고한 자료는 이런 것들입니다). - Library Evaluation Rankings 자바스크립트 라이브러리 선택 시 어떤 것을 먼저 보는지에 대한 질문인데 1위가 Doc..
윈도우 운영체제에서 node.js 업데이트하기 "node.js 업데이트" 키워드로 검색해보면 n(Interactively Manage Your Node.js Versions)을 설치해서 업데이트하는 가이드를 제공하는 글이 많은데 n은 윈도우 운영체제를 지원하지 않습니다. https://github.com/tj/n GitHub - tj/n: Node version management Node version management. Contribute to tj/n development by creating an account on GitHub. github.com 무시하고 설치를 시도하면 에러가 나고 진행이 되지 않습니다. 그냥 사이트가서 LTS 버전 받고 설치해야 한다고 하네요 ㅠㅠ
BPPKWBLT 파일 확장자는 뭔가요? 어느 날 갑자기 한글 파일(hwp) 확장가가 BPPKWBLT로 변경되고 열리지 않는 현상입니다. 변경된 시간이 일치하고 없던 README 파일이 만들어진 것을 보면 랜섬웨어로 추측됩니다. 패턴을 보면 Magniber 랜섬웨어인 듯싶네요. 복구가 가능한 이전 버전 랜섬웨어는 확장자로 검색하면 검색 결과가 나옵니다. 하지만 "BPPKWBLT"라는 확장자는 검색해도 아무런 결과가 나오지 않습니다. 이전 버전과 다른 랜섬웨어라는 것이죠. 찾아보면 Magniber 랜섬웨어 복구툴이라고 해서 안랩 등에 올라와 있는 것이 있는데 이게 2018년 이전까지는 복구가 가능했지만 현재 배포되는 랜섬웨어(확장자로 검색되지 않는)는 복구가 불가능하다고 합니다. 복구툴을 받아보면 확장자로 먼저 체크하게 되어 있는데 지원하지 않는..
마크다운 언어 서버 공개? 8월 중순에 올라온 소식인데 VS Code에서는 마크다운 편집을 하려면 서버가 필요한 건가라고 생각하고 지나갔다가 내용을 다시 살펴보았습니다. VS Code 블로그에 올라온 글은 개발자 Matt Bierner의 개발 후기 같은 것이었네요. Matt Bierner는 2014년 케이스웨스턴리저브대학교를 졸업하고 Microsoft 정규직이 됩니다. 학교에 다니면서 Amazon, Microsoft 인턴 경력이 있구요. 하여간 내용을 정리해보면 2016년 VS Code 팀에 합류해서 마크다운 지원 기능을 개발했다고 합니다(아마도 확장 기능으로 만든 것이었던 것 같네요). 확장 기능도 쓰기에는 큰 문제가 없었는데 대규모 문서의 링크 수정 같은 문제를 다루기에는 한계가 있다는 것을 느꼈습니다. 그 전에는 마크다운을 ..
반응형

티스토리툴바