본문 바로가기

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

2022년 7월 테크니컬 라이팅 이런 저런 소식

반응형

7월 4일

AWS 일부 문서에는 "기여자(Contributors)" 항목이 있습니다. 테크니컬 라이터뿐 아니라 문서 작성에 관여한 컨설턴트, 엔지니어의 이름이 기록됩니다(주로 백서 성격의 문서인 경우에 항목이 있습니다). 내부적으로는 버전 관리를 하면서 누구누구가 해당 문서를 작성하고 검토했는지 알 수는 있겠지만 이처럼 외부에 문서 작성에 기여한 이들의 이름을 표기하는 방식도 신선하네요.

https://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/security-reference-architecture/contributors.html

 

 

7월 5일

아마존 웹 서비스의 테크 에반젤리스트 윤석찬 님의 글입니다. 아마존에서의 글쓰기 문화에 대한 이야기는 많이 공유되고 있지만 일반적인 엔지니어에 비해 좀 더 많이 말을 하고 글을 쓰는 자리에 있어서 그런지 좀 더 쉽게 정리된 느낌입니다.

http://channy.creation.net/blog/1620

 

어제 공유된 "The Delivery Hero Reliability Manifesto" 번역글에서 "모든 텍스트 커뮤니케이션에는 언제나 선의를 주려는 의도가 있음(charitable)을 생각하며 이해하라."라는 문장이 어떤 의미인지 궁금했는데 그 내용도 살짝(5. 예의 바른 태도와 정중한 표현) 담겨 있네요.

https://moonsub-kim.github.io/docs/delivery-hero/reliability-manifesto

 

7월 8일

테크니컬 라이터의 이야기입니다. 첫 번째는 기술지원 근무 경력에서 테크니컬 라이터로 두 번째는 엔지니어에서 테크니컬 라이터로 전환한 사례입니다.

...기술 문서의 중요성을 인지하지 못하는 사람들을 보면 한편으론 안타깝다. 문서가 정말 잘돼 있는 회사를 아직 안 다녀봐서 중요성을 깨닫지 못하는 건 아닐까?...

https://brunch.co.kr/@sunnywhynot/78

 

...문서를 기술 작가가 제작할 수 있는 하나의 제품이라고 본다면, 문서를 만들기 위해 인문학적 접근이 필요할 수도 있고, 공학적 접근이 필요할 수도 있는 것입니다.
그리고 "제품"이라면 "문서"만이 최종 결과물이라고 정해 놓을 이유 또한 없습니다. 즉, 저는 이 분야가 특정 분야의 전유물이라고 생각하지 않습니다...

https://tech.devsisters.com/posts/from-engineer-to-techwriter/

 

7월 21일

지난 1월에 배민에서 '테크니컬 라이팅 코치' 모집 공고가 올라왔었는데 유영경 님이 배민으로 가셨군요. 하여간 다음 주 수요일(27일)  '개발자도 글을 잘 써야 한다고요?!'라는 제목으로 개발자 대상 온라인 토크쇼를 진행한다고 합니다.

https://techblog.woowahan.com/8917/

 

7월 우아한테크세미나 토크쇼 | 개발자도 글을 잘 써야 한다고요?!: 개발자를 위한 글쓰기 코칭의

[신청시작] 글쓰기, 어떻게 시작할까요? 우아한형제들의 테크니컬 라이팅 코치와 함께 힌트를 얻어 보세요!

techblog.woowahan.com

7월 26일

기사 본문 중 좀 색다른 일을 하고 있는 테크니컬 라이터 이야기가 나와 소개해드립니다.

...내게 큰 희망을 준 분도 있었다. LG전자 고객가치혁신실에서 접근성 업무를 담당하고 있는 박세라님이었다. 그녀는 본인을 “전자 기기를 사용할 때, 촉각적인 보조 장치가 필요한 사용자를 위해서 점자 스티커 개발을 하거나, 음성 설명서를 개발하는 테크니컬 라이터”라고 소개했다. 가전제품을 사용하는 고객 중에서 나이가 많거나 신체 활동이 어려운 분들을 불러 테스트하면서, 제품 사용에 불편함을 개선하는 업무를 하는 역할이라고 했다...

https://www.chosun.com/national/weekend/2022/07/23/PC4TBXTMKBAJVKPGHD6W273I3Q/

 

찾아보니 작년 3월에 LG전자에서 세탁건조기 제품에 시각장애인 음성서비스에 특화된 음성 매뉴얼을 도입했다는 기사가 있더군요. 

...이 매뉴얼은 시각장애인을 배려해 사용자가 직접 제품을 만지면서 도어를 여는 방향, 조작부나 버튼 위치 등을 쉽게 연상할 수 있도록 설명한다. 또 전원 버튼이나 세탁·건조 선택 버튼을 누르는 경우 등 제품의 작동 상황별 소리도 함께 안내한다... 

https://n.news.naver.com/mnews/article/629/0000070453?sid=105 

 

LG전자, 시각장애인용 음성 매뉴얼 도입 "가전 접근성 제고"

트롬 워시타워에 시각장애인 위한 음성 매뉴얼·점자 스티커 도입 [더팩트ㅣ이성락 기자] LG전자가 가전제품의 고객 접근성을 강화한다고 4일 밝혔다. LG전자는 최근 원바디 세탁건조기 트롬 워

n.news.naver.com

 

7월 27일

법령정보에 '한눈보기' 서비스가 있는 건 처음 알았네요. 기사를 찾아보니 2021년 12월에 공개된 서비스네요. 법령을 설명하기 위한 시각적 자료인데 모든 이미지 하단에는 "어떠한 법적효력도 없음을 알려드립니다"와 같은 문구가 달려 있습니다. 
아마도 법령 개정 시 이미지가 같이 업데이트되지 못할 가능성을 염두에 둔 것이 아닌가 싶습니다. 코드와 동기화되지 못하는 기술문서와 비슷한가 봅니다.

https://news.korean.go.kr/index.jsp?control=page&part=view&idx=13225 

 

7월 28일

어제 저녁 진행된 [7월 우아한테크세미나] 개발자도 글을 잘 써야 한다고요?!: 개발자를 위한 글쓰기 코칭의 시간! 영상입니다. 라이브 진행한 영상을 그대로 공개한 것이라 약 10분 정도부터 보시면 됩니다.

https://youtu.be/xu3XGEomRWI?t=580

내용이 길어서 다 보기 귀찮은 분들은 잘 정리된 개발자 후기 공유해드립니다(여러 방식으로 블로그를 운영한 경험이 있는 개발자 관점에서 쓴 글입니다). 저는 어제 축구를 보느라 영상은 보지 못했습니다 ^^

https://velog.io/@ohju96/22%EB%85%84-7%EC%9B%94-%EC%9A%B0%EC%95%84%ED%95%9C%ED%85%8C%ED%81%AC%EC%84%B8%EB%AF%B8%EB%82%98-%EA%B0%9C%EB%B0%9C%EC%9E%90%EB%8F%84-%EA%B8%80%EC%9D%84-%EC%9E%98-%EC%8D%A8%EC%95%BC-%ED%95%9C%EB%8B%A4%EA%B3%A0%EC%9A%94-%ED%9B%84%EA%B8%B0

 

728x90