책을읽자 (819) 썸네일형 리스트형 [리뷰] Technical Writing for Developers 원제는 "Technical Writing for Developers: Utilizing HTML, JavaScript, Markdown, and GitHub for Writing"라는 긴 제목입니다. 제목에 목차를 다 담고 있네요. 하지만 내용은 개발자를 위한 테크니컬 라이팅이라기보다는 테크니컬 라이터를 위한 기본 지식 정도가 적당하지 않을까 싶네요.https://www.amazon.com/Technical-Writing-Developers-Utilizing-JavaScript/dp/B0FPF7VB81 Apress 출판사의 포켓 가이드 시리즈로 출판되었고, 딱 손에 들어오는 작은 크기의 책입니다. 2026년 1월 출판된 책이구요. 1장부터 6장까지는 기본적인 HTML, CSS, 자바스크립트 문법을 다룹.. [리뷰] DQTI (5) 2장 Developing quality technical information 1장은 3판을 위한 개요라고 한다면 2장은 전통적인 DQTI를 위한 개요입니다. 하지만 이전 판과는 내용이 좀 다르긴 합니다. 2판(1장)과 3판(2장)의 첫 문장을 비교해 볼까요? (2판)What is technical information? And how is quality technical information different from just technical information? 장 제목 그대로 반영된 첫 문장입니다. 기술 정보가 무엇이고 양질의 기술 정보는 무엇이 다른지 이 책에서 설명하겠다는 내용입니다. (3판) The evolution in technical information isn’t just about delivery formats. It’s also about refinin.. [리뷰] DQTI (4) 1장 Technical information continues to evolve 1, 2장은 Introduction 파트입니다. 장 제목에서 알 수 있듯이 테크니컬 인포메이션 분야는 지금도 계속 새로운 방향으로 나아가고 있고, 그 과정에서 이 책을 펴낸 것이다라는 의미를 강조하고 있습니다. 이 책이 출판된 것은 2014년인데, 이제 막 Headless 개념이 등장하면서 한번 더 테크니컬 라이팅 시장이 바뀌기 시작할 때입니다. 이 책의 저자들이 90년대 경력을 시작했다면 DTP, 온라인 문서, CMS 등의 변화를 몸으로 겪은 세대였다는 거죠(3판 저자는 대부분 80년대 후반에서 90년대 초반에 졸업을 했습니다. 졸업 후 바로 경력을 시작했다면 90년대 경력을 시작한 것으로 볼 수 있죠). In testing, when users were forced to seek additional .. [리뷰] The Nurnberg Funnel 서울경제 2015년 2월 27일 "설명서의 멸종"이라는 기사 일부입니다. 퍼퓰러 사이언스 기사 "The Disappearance Of The Instruction Manual"를 번역한 글입니다. https://www.popsci.com/instructions-not-included/https://www.sedaily.com/NewsView/1H91FUT94V...그는 연구실에 비서를 채용해 컴퓨터와 사용설명서를 지급한 뒤 일상적 사무를 처리토록 지시했다. 결과는 당혹스러웠다. 피실험자인 비서들이 매뉴얼을 읽을수록 오히려 혼란에 빠지는 사례가 많았던 것이다. "비서 희망자들이 매뉴얼을 읽은 뒤 저를 올려보며 이렇게 말하더군요. '이 일은 제가 못하겠어요.'라고요. 그리고는 일어서서 코트를 입고 사라졌죠... [리뷰] DQTI (3) 목차 글을 시작하고 나서 이런저런 다른 일을 하느라, 다음 글을 계속 못 올리고 있습니다.이번에는 좀 목차만 살펴봅니다. 책 전체 목차가 따로 공개된 사이트가 없어서, 따로 정리를 했구요. 목차만 보면 대략적으로 이 책에서 어떤 내용을 다루는지 알 수 있습니다.테크니컬 라이팅 강의을 시작하고 나서 이런저런 다른 일을 하느라, 다음 글을 계속 못 올리고 있습니다. 이번에는 좀 목차만 살펴봅니다. 책 전체 목차가 따로 공개된 사이트가 없어서, 따로 정리를 했구요. 목차만 보면 대략적으로 이 책에서 어떤 내용을 다루는지 알 수 있습니다. 테크니컬 라이팅 강의 "글로벌 글쓰기 표준을 통한 직장인들의 글쓰기 및 번역 기초"에서는 "1 Consistency 3 Easy 9 Quality Characteristics"라고.. [리뷰] DQTI (2) Producing Quality Technical Information DQTI는 1983년 IBM 내부 가이드로 작성된 "Producing Quality Technical Information"를 기반으로 합니다. 일부 항목은 변경이 있지만, 기본적인 가이드는 유지되고 풍부한 예시와 설명이 추가되면서 책으로 펴낼 수 있었습니다. 1983년판 저자 중 한 명인 Morris Dean은 2002년 ACM Journal of Computer Documentation에 "Producing Quality Technical Information" 사본을 기고합니다. Producing quality technical informationhttps://dl.acm.org/doi/10.1145/604228.604232 1983년 가이드 실물 이미지는 찾지 못했습니다. 다만 A4 기준이라고 .. [리뷰] DQTI (1) 저자 소개 Developing Quality Technical Information에 대한 리뷰를 시작하려고 합니다. 2014년 출판된 마지막 에디션(3판)을 기준으로 작성합니다. 내용이 많아질 것 같고 중간중간 다른 곳으로 빠질 수 있어서, 번호를 붙이도록 하겠습니다.제목이 길이서 약자인 DQTI로 작성합니다(실제 쓰이는 약자입니다). 첫 번째는 저자 소개입니다. 1판에 참여한 저자부터 3판에 새로 합류한 저자까지 최근 근황을 살펴봅니다. 1판은 1998년에 출간되었습니다. 저자는 아래와 같습니다.Gretchen Hargis, Ann Kilty Hernandez, Polly Hughes, Jim Ramaker, Shannon Rouiller, Elizabeth Wilde1판 표지에는 Gretchen Hargis .. [리뷰] DOCS LIKE CODE 책 제목은 DOCS LIKE CODE(코드처럼 문서 다루기)입니다. 요즘에는 많은 곳에서 이런 방식을 채택하고 있지만, 얼마 전까지만 해도 이런 문화가 널리 퍼지지는 않았습니다. 2022년에 출간된 책이라 좀 오래된 내용일 수도 있습니다.https://www.amazon.com/Docs-Like-Code-Collaborate-Documentation/dp/1387531492저자인 Anne Gentle는 Rackspace와 Cisco에서 오픈스택(OpenStack)과 오픈스택 기반 클라우드 제품 문서화를 담당했습니다. Rackspace의 동료였던 Diane Fleming과 Kelly Holcomb이 책을 쓰는데 도움을 준 것 같습니다. 종이책 기준으로 96페이지 분량이고 5개 챕터와 1개 부록으로 구성되.. 이전 1 2 3 4 ··· 103 다음
