2021/09 (12) 썸네일형 리스트형 API The Docs 2020 - API와 개발자 경험 Lorna Mitchell은 통신 서비스를 제공하는 보네이지(Vonage)의 DR팀 담당자입니다. 좋은 API라도 문서가 없다면 개발자들이 이를 사용하는데 어려움을 겪는다는 이야기입니다. 좋은 API 문서 또는 환경을 만들기 위해 어떤 것이 필요한지 설명하고 있습니다. 개발자들이 문서나 기능을 살펴볼 때 모든 항목을 한 번에 보지는 않습니다. 발표자는 이런 모습을 식당에서 메뉴판을 보고 주문하는 것이 비유했는데요. 특별한 경우가 아니면 모든 메뉴를 주문하지는 않는 모습과 비슷하다고 합니다. 때문에 문서를 만들 때는 적절한 분류를 통해 개발자가 원하는 항목을 선택할 수 있도록 해야 합니다. 메뉴판에 기재된 문서(음식)은 부족함이 없어야 합니다(마치 식당에 갔는데 메뉴마다 너무 편차가 심한 경우에는 좋은 식.. Guardian Typerighter 개발 스토리 "How we made Typerighter, the Guardian’s style guide checker"라는 글에 대한 요약정리입니다. 원문은 아래 링크를 참고하세요. https://www.theguardian.com/info/2021/jan/26/how-we-made-typerighter-the-guardians-style-guide-checker How we made Typerighter, the Guardian’s style guide checker Lots of regular expressions, and a timely demonstration by an editorial colleague, led to a two year side-project that eventually ended up.. API The Docs 2020 - API 문서 최적화 발표자인 Michael Meng은 테크니컬 라이터 경력을 가지고 있으며 지금은 Merseburg University의 교수로 일하고 있습니다. https://www.hs-merseburg.de/hochschule/information/personenverzeichnis/details/person/meng-michael-370/ Details Tätigkeitsbereiche Textanalyse und Textproduktion Technische Dokumentation Usability und Forschungsmethoden www.hs-merseburg.de 이번 발표는 SIGDOC 컨퍼런스에서 발표한 논문에 대한 이야기입니다. 논문 내용을 그대로 설명한 것은 아니고 어느 정도 컨퍼런스 주제에 맞.. 모밀꽃 필 무렵은 왜 메밀꽃 필 무렵이 되었을까? 페북에서 "메밀꽃 필 무렵"이 원래는 "모밀꽃"이었다는 이야기를 보고 갑자기 궁금해졌습니다. 관련해서 여러 글이 있지만 논문 형식으로 작성된 것은 "이재춘 (1998). 문학작품 원본의 오류와 변개 양상-이효석의 모밀꽃 필 무렵을 중심으로. 우리말글, 407-429"라는 글이 있더군요. 해당 논문에서 이야기하는 것은 이 작품의 문제 뿐 아니라 30년대 이전 또는 방언을 사용한 작품이 교과서 등에 실리면서 현대국어로 변형하는 과정에서 작가의 의도를 해치는 문제가 많다는 것입니다. 소설보다는 시에서 그런 면이 더 강하게 나타나고 있구요. "메밀꽃 필 무렵"의 경우는 그런 문제도 있지만 원본 자체가 가지고 있는 오류를 잘못 해석해서 판본에 따라 전혀 다른 이야기로 바꾸어버리는 일도 있다고 합니다. (조광, 1.. NHN 테크니컬 라이터가 추천하는 테크니컬 라이터를 위한 참고 도서 (2) '개발자를 위한 글쓰기 가이드 / 유영경 / 로드북'에서 참고자료(도서) 목록을 정리했습니다. 이번 글에서는 번역되지 않는 책을 소개합니다. 1. Technical Writing 101 제목처럼 테크니컬 라이팅의 기본적인 원리와 방법을 안내합니다. books.google.co.kr/books?id=fKwZAgAAQBAJ Technical Writing One Hundred One 서평을 찾을 수 없습니다. books.google.co.jp 2. Technical Editing 문서 편집자 관점에서 프로젝트를 설계하고 테크니컬 라이터와 어떻게 협업을 진행할 것인지부터 시작해서 문서 배포를 위한 도구, 문서 편집에 대한 내용을 다룹니다. books.google.co.kr/books?id=BuZgSQAACAA.. 개발자의 글쓰기, 개발자를 위한 글쓰기 가이드 '개발자의 글쓰기'는 2019년 10월 초판이 나왔습니다. 이공계를 위한 글쓰기 책은 꽤 많이 나와있고 대학에서도 기본 교양 과목으로 가르치고 있습니다. 하지만 개발자만을 위한 글쓰기 가이드는 없었습니다. 책 표지부터 변수 네이밍, 릴리스 노트, 장애 보고서 같은 실무적인 영역을 건드리고 있습니다. 그리고 저자인 김철수 님이 다양한 주제의 기업 강의를 진행하고 있는데 거기에 '개발자의 글쓰기'라는 강의 콘텐츠가 추가되는 형태라 단체로 책을 주문하고 강의를 진행하는 건도 꽤 있는 듯합니다. '개발자를 위한 글쓰기 가이드'는 테크니컬 라이터가 쓴 글쓰기 가이드입니다. 2003년 'HTML HELP FILE 제작과 실무' 이후 18년 만에 나온 책입니다(중간에 '서비스 글쓰기의 모든 것'이 있지만 이건 공저자.. Windows 터미널에서 글꼴 수정하기 공식 가이드 문서에서도 "설정" 메뉴를 선택하면 문서 에디터에서 JSON 파일이 열리고 편집을 할 수 있다고 나옵니다. https://docs.microsoft.com/ko-kr/windows/terminal/get-started 하지만 아무리 "설정" 메뉴를 선택해도 간단한 설정 항목만 보이고 JSON 파일이 열리지 않습니다. 다른 블로그에서도 이렇게 설명을 하고 있구요 ㅠㅠ 혹시나 해서 영문 가이드 문서를 열어보았습니다. https://docs.microsoft.com/en-us/windows/terminal/get-started Windows Terminal installation In this quickstart, you will learn how to install and set up Windo.. 식빵언니는 진짜 비싼걸까? 배구선수 김연경을 모델로 출시된 "식빵언니"의 가격에 대한 뉴스가 조금씩 올라오고 있습니다. 대부분 커뮤니티에서(또는 네티즌들이) 가격에 대한 불만을 이야기하더라~ 뭐 그런 뉴스입니다. 소포장 식빵이 시중에 출시된 것이 처음은 아닙니다. 2017년에 아워홈에서 "신선한 버터우유식빵"이라는 이름으로 소포장 식빵을 출시했습니다. 아마도 편의점 채널을 통해 판매된 것 같구요. 포장 겉면에 "2장이 들어있어요"라고 강조하고 있는 걸 보면 소비자의 오해를 최소화하려는 노력이 있었던 것 같습니다(아래 이미지와 다르게 실제 판매된 제품은 투명 포장이라 식빵이 2장 들어간 것을 확인할 수 있습니다). 일반 버터우유식빵 2장이 들어가 있고 가격은 500원이었다고 합니다. 좀 더 고급스러운 빵을 찾아보면 GS 계열에서 판.. 이전 1 2 다음
