열이아빠의 어쨌거나 저쨌거나

2026년 6월 테크니컬 라이팅 이런 저런 소식

열이아빠 — Wed, 10 Jun 2026 16:16:01 +0900

6월 10일

For anyone wanting to be a technical writer

https://www.reddit.com/r/technicalwriting/comments/1u0e9zu/for_anyone_wanting_to_be_a_technical_writer/

글쓴이의 답변은 "Don't. Just don't enter tech writing."로 시작합니다. AI 뭐 이런 것이 아니라 직무 자체에 대한 불안정성과 가치에 대한 언급으로 댓글이 불타오르게 되었나 봅니다. 약 170여개의 댓글이 달렸구요. 찬반 의견으로 갈리고 있네요.
특히, "In layoffs, you are the first to go because "you're just a writer."라는 내용은 AI 이전에도 많이 나왔던 주제입니다. 문서를 제품의 일부분이라고 하지만, 어쩔 수 없는 상황에서 제품의 품질을 줄여야 한다면 어느 것을 먼저 쳐낼지는 쉽게 생각할 수 있는 부분이죠.

Nano banana로 생성한 이미지입니다. 텍스트가 잘 표현된다고 하더니 아직 이런 오류들이 있네요.

2026년 5월 테크니컬 라이팅 이런 저런 소식

열이아빠 — Wed, 6 May 2026 14:12:20 +0900

5월 6일

어쩌다 테크니컬 라이터

https://brunch.co.kr/brunchbook/jditw

[연재 브런치북] 어쩌다 테크니컬 라이터

우연한 기회로 연구원에서 테크니컬 라이터로 전직을 하게 되었습니다. 테크니컬 라이터의 회사 생활과 기술 문서 작성의 이모저모를 다룹니다.

brunch.co.kr

요즘에는 브런치북을 많이 사용하시나 봐요. 아무래도 실제 출판과 연결되는 기회가 많이 생겨서 그런지도 모르겠습니다.

현직 테크니컬 라이터(글의 흐름으로 봐서는 현재는 PM이라고 하긴 하지만, 겸업인지 모르겠네요)가 쓰신 글이구요. 물리학을 전공하고 제조 연구 개발직에 있다가 HCI 전공으로 석사를 따고 다시 게임 회사 테크니컬 라이터로 전환했다고 합니다. 그리고 지금은 제조업 테크니컬 라이터로 일하고 있구요. 게임 회사도 PM으로 지원했는데, 테크니컬 라이터 직무를 제안받고 어쩌다 보니 시작하게 된 것이라고 하네요. 흥미로운 커리어를 가진 분입니다.

문서에 자동 갱신되는 스크린샷 넣기 (interblah.net)

https://news.hada.io/topic?id=28950

이미 많이 논의된 주제이긴 한데, 요즘에는 어떻게 하는지 볼 수 있는 글입니다. 댓글을 보면 특히 다국어 모바일 앱의 경우에 유용하다고 하네요. 모바일 앱 특성이 업데이트가 자주 되는 경향이 있고 다국어인 경우 같은 앱 화면을 여러 차례 확인해야 하는 문제가 있어서.

AI 매뉴얼 도입으로 테크니컬 라이터 직무가 사라졌습니다

TCN 오픈 채팅방에 올라온 글입니다. 래딧 등에서는 이런 사례가 꽤 자주 올라오고 있는데, 국내에서도 이런 사례가 생기고 있나 보네요. 글을 올리신 분의 조직에서는 테크니컬 라이터 직무를 따로 두지 않고 개발자가 작성한 초안을 AI를 통해 손을 보고 퍼블리싱하는 방식이 아닌가 싶습니다.

래딧에 이런 글이 올라오면 이런 어두운 시기는 금방 지나간다는 의견과 이제는 끝났다는 의견이 대립하는데, 국내의 경우에도 안 그래도 적었던 테크니컬 라이터 구인글이 더 적어지고, 콘텐츠 관련 구인 역시 많이 줄었다는 이야기도 있습니다.

Developing internal skills for recurring documentation processes like release notes

https://idratherbewriting.com/blog/internal-skills-release-docs

Tom Johnson의 게시물입니다. 이전에도 AI를 활용한 릴리스 노트 작성에 대한 글도 자주 올리고, 강연도 했었는데요. 이번에 올라온 글은 이제는 완벽하다는 느낌의 글입니다.

...This past week, I finally had a “no-gremlin” release for one of the products. By no-gremlin release, I mean there wasn’t some issue that complicated the skills I’d developed for AI agents to write the release notes.
In previous weeks, there always seemed to be gremlins that got in the way. Sample gremlins might include migrated directories that broke scripts, deprecated APIs merged with other APIs, rollbacks at the last minute (often due to errors I find), errors in the source code with release tags, problems in the build system, and more. All of these issues required human intervention and workarounds. But I expect these gremlins will get fewer and fewer...

물론 이렇게 해서 테크니컬 라이터가 할 일이 사라지는 건 아닙니다. 릴리스 노트처럼 반복적인 작업을 줄이고 좀 더 가치 있는 작업에 몰두할 수 있게 되었다는 이야기죠. 참고로 Tom Johnson는 구글에서 automotive 분야 테크니컬 라이터 업무를 맡고 있습니다. 다른 조직보다는 좀 더 AI 활용이 용이한 환경이구요. 다른 조직에서도 이렇게 하려면 꽤 많은 수준의 지원을 받아야 할 겁니다.

...The skill has cleared up my bandwidth to focus on other, less repeatable doc work — things like updating reference doc content, improving conceptual guides, and other work I’d been putting off for months. That’s the real payoff: not just doing the same work faster, but finally getting to the work I wasn’t doing at all...

Write the Docs Portland 2026

행사가 마무리되었다고 합니다. 사진은 플리커에 공유되고 있구요. 영상은 1주일 정도 후에 올릴 예정이라고 합니다.

https://www.flickr.com/photos/writethedocs/

5월 8일

Documentation Salary Survey: 2025 Results

https://www.writethedocs.org/surveys/salary-survey/2025/

설문의 목적 자체가 급여에 대한 정보를 얻기 힘든 분들을 위해 연봉 협상 시 내가 이 정도 일을 하면 이 정도는 받아야 한다는 자료를 제공하기 위한 것이었습니다. 그래서 사실 한국에서 일하는 이들에게는 큰 정보가 아니었는데, 올해 설문은 환경적인 변화에 대한 몇 가지 지표를 보여주고 있어서, 참고할만합니다. 다만, 좋은 변화는 아닙니다.

The share of employees feeling less confident in their job security rose from 21.9% to 36.0%.
직업 안정성에 대한 질문에 대해서는 불안정하다고 느끼는 비율이 급격하게 늘어났습니다. 주변에서 대량 해고도 많이 볼 수 있고, AI로 인한 영향도 없지 않겠죠.

Among employees, the trend has shifted significantly toward the negative compared to 2024. In 2025, 38.0% reported feeling “not confident” (up from 27.5%) and 8.3% “not confident at all” (down from 11.3%). Those feeling “confident” dropped to 25.0% (from 30.0%), and “very confident” fell sharply to 3.7% (from 10.0%).
새로 구직을 하는 이들도 마찬가지입니다. 이전보다 적은 수준의 급여를 받으면서 일해야 하는 선택이 많아졌고 그마저도 구하지 못하는 상황이 많아지기 때문입니다.

Technical Writer Conference

https://www.techwriterconference.com/#/agenda?day=1&lang=en

6월 23일 진행 예정인 온라인 컨퍼런스입니다. 유료이고, 티켓에 다시보기가 포함된 것을 보면 일반 공개는 하지 않을 것 같네요.

아젠다 보고 궁금하시면 신청해 보시는 것도 ^^ 이런 컨퍼런스에 참여하는 비용은 강연보다는 네트워크가 더 강하지 않을까 싶긴 합니다.

5월 11일

Head of Learning & Content Experience

https://careers.snowflake.com/us/en/job/SNCOUS80E1D7E73CC143C6BA8543307C25209DEXTERNALENUS58656EA6D1E74CDBAE65C8D4C5457D7D/Head-of-Learning-Content-Experience

평소라면 그냥 평범한 콘텐츠 관리자 구인 공고겠지만, 이 공고의 출처인 snowflake가 최근 테크니컬 라이팅 팀 전체를 날려버려서 화제가 되었던 조직이라서, 새로운 구인 공고에 관심이 많네요.

Core Responsibilities를 살펴보면 AI와 관련된 내용이 많습니다. 관리자 역할이지만 콘텐츠를 생성하는 작업도 책임지게 됩니다. AI를 통한 콘텐츠 생성을 관리하는 역할이겠지요.

Operationalize AI across the learning lifecycle to create AI-ready content through modular design, structured taxonomy, and personalized interaction models.

기존처럼 정해진 교육을 제공하는 것이 아니라 AI 도구에 자연스럽게 교육 과정이 통합되는 것도 담당하게 됩니다.

Define role-based onboarding and maintain core sales methodologies (e.g., MEDDPICC, PEAK), embedding them into AI-enabled reinforcement tools rather than point-in-time training.

경험 있는 테크니컬 라이팅 조직이 했던 일을 혼자서(또는 소수의 인원으로) 담당해야 하는 것이라, 쉽지는 않아 보입니다.

최소 자격 요건이 10년 이상 경력이고 5년 이상 리더십 경력을 가지고 있어야 하네요.

5월 18일

Write the Docs Portland 2026 발표 영상 다시 보기

최근에는 거의 행사 끝나고 1주일 정도 후에 올라오는 것 같습니다.

https://www.youtube.com/playlist?list=PLZAeFn6dfHpkMzZFXFye22pKbafhhC3Cp

스케치 노트도 같이 공개가 되었습니다. 예전에는 이 분이 작업한 스케치 노트 그림이 맘에 들지 않았는데, 요즘에는 나름 개성이 있어 보입니다. 물론 ChatGPT에서도 이런 스타일로 그려달라 하면 또 그려주긴 하지만요~

https://www.flickr.com/photos/writethedocs/albums/72177720333614185/

5월 26일

래딧 소식 몇 가지

Technical Writer to Product Manager

https://www.reddit.com/r/technicalwriting/comments/1tlslp6/technical_writer_to_product_manager/

댓글 중 흥미로운 언급이 있어서 가져왔습니다. 물론 농담이라고 하긴 했지만.

최근 이런 주제의 글이 많긴 합니다. 테크니컬 라이터가 커리어를 계속하기 힘들 것이라는 예측이기도 하지만, 이런 직무 전환에 대한 문의는 예전부터 많긴 했습니다. PM이라든지, 데브릴 조직으로 옮기는 것이 아마도 테크니컬 라이터에게는 가장 무리가 없으면서도 도전해 볼 만한 직무이긴 합니다.

...사실 전환은 꽤 매끄럽습니다. 엔지니어들에게 "어떻게" 만들었는지 묻는 대신 "언제 만들 건가요?"라고 묻기 시작하면 되죠...

The 2026 tech writer layoffs: What senior writers should do right now
https://hackmamba.io/technical-writing/technical-writers-ai-layoffs-2026/

https://www.reddit.com/r/technicalwriting/comments/1tig0p4/just_heard_about_the_layoffs_of_technical_writers/

개발자 마케팅 업체에서 올라온 글이라, 약간은 상업적인 내용이 담겨 있지만, 그 내용 자체는 꽤 흥미로웠는지 꽤 많은 추가 의견이 나오고 있습니다. 대량 해고가 이어지고 있지만 기술적인 배경을 가진 테크니컬 라이터에 대한 수요는 늘어나고 있다고 주장하고 있는데, 그 역시 글쓴이의 가정일 뿐입니다. 오히려 API 문서처럼 정형화된 형식으로 구조화할 수 있는 영역이 더 위험할 수 있죠.

...API documentation with technical depth is still in demand. The roles that are filled take different shapes. Job postings now read "Python preferred" or "experience with AI tools," and they list OpenAPI, Postman, or Docusaurus as expectations rather than nice-to-haves. That word "preferred" is doing the filtering work. It is the polite way of saying you will be tested on it, even if the recruiter does not say so...

I promise you that technical writers are still needed

https://www.reddit.com/r/technicalwriting/comments/1tiswuj/i_promise_you_that_technical_writers_are_still/

글쓴이는 최근 규모가 큰 조직에 합류했는데, 엄청난 분량의 문서 속에서 정작 쓸만한 문서는 별로 없어서 충격이었다는 고백입니다. 이런 이슈는 테크니컬 라이팅 분야에서 꽤 많이 언급된 내용입니다. 엄청난 부채를 가진 문서들에 대한 이야기이고, 해당 조직은 이런 문제에 대해 큰 관심을 가지고 있지 않다는 겁니다. 이런 상황에서 AI를 도입했을 때 문제는 여전할 것이다라는 건데, 아마도 어딘가에서는 AI를 통해 이런 문제를 해결할 수 있는 방안을 찾아낼 것이고, 그럼 글쓴이의 희망적인 생각도 바뀌어야 할 겁니다.

5월 28일

Looking back at the AI Book Club one year in

Tom Johnson이 운영하는 AI 북클럽이 지난 1년간 읽고 토론했던 책들이라고 합니다. AI 분야의 책들을 찾아보신다면 참고하세요. 14권 중에 2권은 번역서가 없습니다. 12권의 번역서 목록만 올려봅니다 (간혹, 제목 번역이 이상해서 원서와 연결하기가 쉽지 않아서 ㅠㅠ)

https://www.linkedin.com/posts/tomjoht_looking-back-at-the-ai-book-club-one-year-activity-7462132691975430144-mUoh/

Life 3.0: Being Human in the Age of Artificial Intelligence by Max Tegmark
맥스 테그마크의 라이프 3.0 (맥스 테그마크, 동아시아, 2017)
Breakneck: China's Quest to Engineer the Future by Dan Wang
브레이크넥 (댄 왕, 웅진지식하우스, 2026)
If Anyone Builds It, Everyone Dies: Why Superhuman AI Would Kill Us All by Eliezer Yudkowsky and Nate Soares
AI, 신의 탄생 인간의 종말 (엘리에저 유드코스키, 네이트 소아레스, 상상스퀘어, 2026)
Careless People: A Cautionary Tale of Power, Greed, and Lost Idealism by Sarah Wynn-Williams
케어리스 피플 (세라 윈윌리엄스, 디플롯, 2026)
God, Human, Animal, Machine: Technology, Metaphor, and the Search for Meaning by Meghan O'Gieblyn
번역서 없음
Co-Intelligence: Living and Working with AI by Ethan Mollick
듀얼 브레인 (이선 몰릭, 상상스퀘어, 2025)
Nexus: A Brief History of Information Networks from the Stone Age to AI by Yuval Noah Harari
넥서스 (유발 하라리, 김영사, 2024)
Hands-On Large Language Models: Language Understanding and Generation by Jay Alammar and Maarten Grootendorst
핸즈온 LLM (제이 알아마르, 마르턴 흐루턴도르스트, 한빛미디어, 2025)
Empire of AI: Dreams and Nightmares in Sam Altman's OpenAI by Karen Hao
AI 제국: 권력, 자본, 노동 (카렌 하오, 생각의 힘, 2026)
AI Superpowers: China, Silicon Valley, and the New World Order by Kai-Fu Lee
AI 슈퍼파워 (리카이푸, 이콘, 2019)
Supremacy: AI, ChatGPT, and the Race that Will Change the World by Parmy Olson
패권 (파미 올슨, 문학동네, 2025)
The Singularity Is Nearer: When We Merge with AI by Ray Kurzweil
마침내 특이점이 시작된다 (레이 커즈와일, 비즈니스북스, 2025)
The Coming Wave: Technology, Power, and the 21st Century's Greatest Dilemma by Mustafa Suleyman
더 커밍 웨이브 (무스타파 술레이만, 한스미디어, 2024)
More Than Words: How to Think About Writing in the Age of AI by John Warner번역없음

아래 링크에서 각 도서 토론 레코딩 자료도 확인할 수 있습니다.

https://idratherbewriting.com/ai-book-club/#previous

5월 29일
https://www.reddit.com/r/technicalwriting/comments/1toxdnu/bye/

본문 내용은 그냥 업계를 떠난다는 이야기인데, 댓글 중에 인상적인 코멘트가 있네요.

Honestly a lot of people in tech writing seem less burned out by the writing itself and more by constantly having to justify the value of their work.

크롬에서 pdf를 열고 복사를 했는데, 숫자와 기호가 분리되는 현상

열이아빠 — Wed, 22 Apr 2026 10:59:15 +0900

혹시나 해서 어도비 애크로뱃 리더에서 확인했는데, 정상입니다.

이런 문제가 생기면 어도비 애크로뱃 리더를 사용하세요. 끝.

(추가) 어도비 애크로뱃 리더에서도 같은 문제가 생기는 텍스트가 있네요. 좀 더 나을 뿐 완벽하지는 않다는 ㅠㅠ

ChatGPT에게 물어보니 PDF 문서의 구조 때문에 생기는 문제라고 합니다.

PDF는 원래 “문서”가 아니라 글자와 좌표를 찍어 놓은 그림에 가까운 구조입니다.
그래서 텍스트를 복사할 때는 내부적으로 "좌표에 있는 글자들을 사람이 읽는 순서대로 재조합"하는 과정이 필요하니다.

예를 들어 "있고, (3자에게)"라는 표현이 있다고 할 때 내부적으로 좌표값은 아래와 같이 지정됩니다.

(실제로는 좀 더 복잡한 구조로 저장이 됩니다).

(100, 500) → "있고"
(130, 498) → "("
(140, 498) → "3"
(150, 500) → "자에게"
(180, 498) → ")"

숫자와 기호만 y 좌표가 달라지면서 줄바꿈된 행으로 인식이 된다는 겁니다. 일반적으로 약간의 차이가 있을 수 있어서 뷰어에서 이를 보정해 주는데, 크롬 pdf 뷰어에서 보정해 주는 범위가 벗어나면 제대로 복사가 안될 수 있다는 설명입니다. 애크로뱃 리더는 좀 더 보정 로직이 튼튼하고 그래서 이런 문제를 어느 정도 커버해 주는 것이구요.

PDF 스펙 문서는 아래 링크에서 확인할 수 있는데 1310 페이지 분량입니다. 제대로 된 PDF 리더를 만드는 것은 쉬운 일이 아니겠네요.

https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/pdfreference1.7old.pdf

전주콩뿌리콩나물국밥 미금점

열이아빠 — Wed, 22 Apr 2026 09:37:13 +0900

독특하게도 콩나물국밥집인데, 순대국밥이 있습니다. 기본 베이스는 콩나물국밥인데, 얼큰이라 양평해장국 스타일이고, 거기에 순대와 고기가 들어갑니다. 큰 기대는 없었는데, 그냥 소주를 부르는 맛이네요.

물론 순대 자체의 퀄리티는 형편없습니다. 맛은 뭐 그냥 그저. 다만 고기는 괜찮습니다.

역시 독특하게 순대정식 메뉴가 있는데, 수육이나 순대가 나오는 것이 아니라 돈까스가 나옵니다.

주문 단말기에 순대정식이 없어서 물어보니, 그냥 순대국밥이랑 돈까스 주문하면 된다고 하네요. 이건 뭐~~

한 가지 아쉬운 건 반찬입니다. 아무래도 다양한 메뉴를 판매하는 곳이라 어쩔 수 없죠.

https://naver.me/52Rp5GNJ

네이버지도

전주콩뿌리콩나물국밥 미금점

map.naver.com

AI The Docs 2025 - AI 에이전트에 대한 쉬운 설명

열이아빠 — Wed, 15 Apr 2026 17:38:58 +0900

Ronald Ashri는 4년 정도 의료, 보험 업계 대상으로 대화형 AI 플랫폼을 제공하는 스타트업을 창업해서 운영하고 있습니다. 박사 학위 논문 제목이 "Models for agent - based infrastructures"인데, 굳이 박사 학위 논문을 언급하는 이유는 그 이전부터 에이전트 기반 소프트웨어에 대해 관심을 가지고 있었다는 것을 강조하고 싶었다고 합니다. 그래서 이번 세션에서는 AI란 무엇인지, 에이전트는 무엇인지 간략하게 정리하고 어떻게 에이전트를 만들고 어떤 식으로 활용하는지 안내하는 것이 목적이라고 합니다.

제목은 '쉬운 설명'이라고 붙였지만, 뒤로 갈수록 개념이 복잡해지긴 합니다. 실제 에이전트가 동작하는 것을 아직 제대로 본 적이 없어서 이 부분은 좀 더 공부가 필요할 것 같습니다.

에이전트는 단지 도구라고 생각했는데, 에이전트를 설명할 때 가장 중요한 개념은 목표(goal)라고 합니다. 문서와 에이전트를 비교해서 설명하는 것이 흥미롭습니다. 아래 이미지를 참고하세요.

그래서, 에이전트 기반으로 작업한다는 것은 목표에 집중한다는 겁니다. 달성하고자 하는 목표 그 자체에 먼저 집중하게 됩니다. 최근에 AI를 사용하고자 하는 많은 이들이 실수하는 것 중 하나는 어떤 도구를 사용할지를 먼저 고민한다는 겁니다. 어떤 것을 만들겠다는 고민 이전에 어떤 모델을 사용할지 어떤 도구를 사용할 지부터 고민하는 겁니다.

문서화를 주제로 에이전트 기반으로 작업한다면 다음과 같은 식의 구조가 나올 수 있습니다. 각각의 에이전트에 문서화 작업에 필요한 목표를 부여하고 어떤 공간에서 어떤 시점에 운영이 되어야 하는지 구성할 수 있다는 겁니다.

에이전트에 있어서 중요한 개념 중 하나는 Self-direction입니다. 예를 들어 특정 온도에 이르면 온도를 낮추는 에이전트를 생각한다면 딱히 판단이라는 것이 없습니다. 그냥 규칙에 따라 동작하는 것뿐입니다. 이런 것은 에이전트 개념에 적합하지 않습니다. 사용자가 목표를 달성하기 위해 에이전트에게 어느 정도의 자율성을 부여할지 어떤 도구를 사용하게 할지 자기 주도성을 허용하는 것이 중요합니다.

또한 목표라는 것이 사용자(인간)이 반드시 설정하는 것은 아닙니다. 에이전트가 주어진 목표를 달성하기 위해서 일을 하다가 어떤 동기에 의해 목표를 새롭게 만들 수도 있다는 거죠. 여기까지 가면 좀 개념이 복잡해지네요.

Ronald Ashri: Designing Software that Acts: Agents beyond LLMs

https://youtu.be/NWbm1ajrGBw?si=C4rbEATFEvv4MuSD

AI The Docs 2025 - 작업 맥락과 Affordances을 고려한 개발자 포털

열이아빠 — Wed, 15 Apr 2026 16:43:11 +0900

Kristof Van Tomme는 Pronovix의 CEO입니다. 항상 첫 번째 세션을 담당합니다. 키노트라고 따로 표시하지는 않지만, 대부분의 경우 최근 트렌드를 살펴보는 시간을 가집니다. 이번 세션에서는 자신이 실제로 사용하는 몇 가지 도구를 소개하면서 이야기를 풀어낸다고 합니다(라고 했지만 특정 도구를 살펴보는 것은 아니고 자신이 가지고 있던 어떤 개념에 대한 설명이 주입니다).

첫 번째 등장한 것은 Google NotebookLM입니다. 저는 초기에 잠깐 살펴보고 그 이후에는 잘 활용을 하지 않고 있는데, 최근 어떤 강의에서 강사가 가장 강조하는 도구가 이것이더라구요. 특히 정보를 정리하는 기능은 따라올 것이 없다고 합니다. 발표자 역시 팀에서 NotebookLM을 활용하고 있고 기존에 자료를 분석하는데 여러 시간이 걸렸던 것을 줄일 수 있었다고 합니다.

AI에 대해 무조건 신뢰하는 이들도 있는데, AI가 모든 것을 완벽하게 해내는 것은 아닙니다(아직은요). 그래서 AI가 어떤 부분을 어디까지 할 수 있는지 알고 이를 활용하는 것이 중요합니다. 이번 세션에서 하고자 하는 이야기가 그것입니다.

발표자가 근본적으로 질문을 던지고 싶은 것은 이것이라고 합니다.

- What creative constraints are no longer valid?

AI가 등장하면서 이전에는 불가능했던 것들 중에 이제는 누구나 할 수 있게 된 것이 무엇일까요? 라는 것입니다.

예를 들어 개발자가 특정 언어에 대한 정보를 구하려면 공식 개발자 포털(또는 문서 사이트)를 방문하는 것이 가장 효과적인 방법이었습니다. 하지만, 이제는 개발자가 더 이상 개발자 포털을 찾지 않습니다. 그냥 AI에게 물어보고 답을 얻거나 심지어는 그냥 생성된 코드만 복사해서 붙여 넣습니다. 그런 상황이라면 조직에서는 개발자 포털을 사용자 편의에 맞게 개발하는데 더 이상 비용을 들이지 않을 겁니다. 그냥 AI가 정보를 획득하고 처리하도록 인터페이스만 열어주겠죠.

도구와 공간에 대한 이야기는 흥미롭습니다. 도구는 사용하는 공간에 따라 다른 의미를 가집니다. 어떤 도구(예를 들어 텐트)는 그 자체가 공간을 만들어내기도 합니다.

개발자 포털을 포함한 소프트웨어는 물리적인 공간을 디지털 세계에 이식하는 작업입니다. 그리고 소프트웨어도 시간에 따라 변화했습니다. 컴퓨터에 설치해서 사용하던 소프트웨어가 시간이 흐르면서 웹 애플리케이션 형태로 변화했습니다.

좀 설명이 애매하긴 한데, 관리자가 특정 형식으로 보고서를 보고 싶다고 합시다. 기존에는 그 형식에 맞게 데이터를 끌어와 보고서를 만들었다면 이제는 AI를 사용해 형식에 맞게 보고서를 생성할 수 있습니다. 도구는 달라지지만, 관리자가 보는 보고서라는 공간은 그대로라는 겁니다. 하지만 그런 형태는 변할 수 있습니다. 앞으로는 사용자의 작업 흐름 속에서 필요할 때만 호출되는 '도구' 형태로 전환될 수도 있다는 거죠. 물론 이건 사용자에 따라 달라질 수 있습니다. 그리고 공간 자체도 이전에는 고정된 공간이었다면 이제는 사용자의 작업 맥락 안에서 공간을 만들어낼 수도 있습니다.

맥락 관련해서는 Alicia Juarrero의 책 'Context Changes Everything: How Constraints Create Coherence'을 언급했습니다(번역서는 없습니다). 관련 팟캐스트는 아래 링크를 참고하시구요.
https://youtu.be/I5cqPct3yXQ?si=8te39pHRC4AhFe65

하여간 결론은 미래의 개발자 포털은 단순히 정보를 담아두는 저장소가 아니라, 에이전트 AI 시대의 변화에 발맞추어 사용자의 작업 맥락과 활용 가능성(Affordances)을 고려한 전략적 플랫폼으로 진화해야 함을 강조합니다.

Kristof Van Tomme: Rethinking web applications in the age of agentic AI

https://youtu.be/8YQzdQh6KKg?si=OBzvG6rYj2-rMnjd

정보시스템 감리수행가이드에서 배우는 글쓰기

열이아빠 — Fri, 10 Apr 2026 13:21:49 +0900

자료는 NIA(한국지능정보사회진흥원) 게시판에서 받을 수 있습니다.

https://www.nia.or.kr/site/nia_kor/ex/bbs/View.do?cbIdx=99860&bcIdx=24365&parentSeq=24365

내용 중 75페이지 "2. 감리계획서 및 감리보고서 작성 원칙"에 보고서를 작성하는 원칙과 정확한 글쓰기에 대한 설명이 포함되어 있습니다. 공문서 작성 원칙 등의 문서를 참고한 것이라고는 하지만, 정보시스템이라는 환경에 맞게 예문과 설명을 추가했으니, IT 분야에서 기술 문서를 작성할 때 참고할만한 내용입니다.

문서의 특성상 명확하지 않은 내용으로 작성된 경우 분쟁이 생길 수 있습니다. 프로젝트 규모에 따라 감리 비용은 억대가 넘어가는 경우도 많아 감리보고서의 중요성은 더 말할 필요는 없겠죠.

내용도 좋지만, 예문이 괜찮습니다. 물론, 약간은 공문서 스타일로 작성된 경향이 없지는 않지만, 원칙적인 부분만 참고하면 될 것 같네요.

이렇게 상상하면 아주 쉽다 .

열이아빠 — Fri, 10 Apr 2026 13:11:49 +0900

2018년 게시된 "[정혁준의 비즈니스 글쓰기] 글 쓸 때도 사람이 먼저다" 기사 일부입니다.

“나는 누이들에게 말하고 있다고 가정하면서 버크셔해서웨이 연례 보고서를 작성한다 . 이렇게 상상하면 아주 쉽다 . 내 누이들은 대단히 명석하지만 재무나 회계 분야는 잘 알지 못한다 . 쉽게 쓴 내용은 이해할 수 있지만 전문용어가 나오면 어리둥절해질 것이다 . 그래서 나는 누이들이 알고 싶어 할 정보를 전달하는 것을 목표로 보고서를 쓴다 . 내게는 셰익스피어처럼 글을 써야 할 이유가 전혀 없다 . 오로지 상대방이 원하는 정보를 주고자 하는 진실한 열망만이 필요할 뿐이다 .”
‘투자의 달인’이라는 워런 버핏 버크셔해서웨이 회장이 미국증권거래위원회(SEC)가 1998년 펴낸 <쉬운 영어 안내서>(A Plain English Handbook) 서문에 쓴 글이다.
https://www.hani.co.kr/arti/economy/economy_general/858022.html

원문은 PDF로 내려받을 수 있습니다. 서문 중 뒷부분에 해당하는 내용입니다.

One unoriginal but useful tip: Write with a specific person in mind. When writing Berkshire Hathaway’s annual report, I pretend that I’m talking to my sisters. I have no trouble picturing them: Though highly intelligent, they are not experts in accounting or finance. They will understand plain English, but jargon may puzzle them. My goal is simply to give them the information I would wish them to supply me if our positions were reversed. To succeed, I don’t need to be Shakespeare; I must, though, have a sincere desire to inform.
https://www.sec.gov/pdf/handbook.pdf

기사에서 "이렇게 상상하면 아주 쉽다"라는 부분은 마치 글쓰기가 쉽다는 것처럼 읽히는데, 원문을 보면 누이들에게 말하고 있다고 가정하는 것이 쉽다는 표현입니다. "I have no trouble picturing them". 물론 중요한 것은 그 뒤에 나오는 쉬운 표현에 대한 설명이지만, 해당 기사의 내용이 이런저런 글쓰기 교육에서 인용되는 부분이라 바로 잡고 싶었습니다.

원문은 No siblings to write to? Borrow mine: Just begin with “Dear Doris and Bertie.”라며 끝나는데, 이 말을 기회 삼아 회사를 차린 이들이 있습니다. 회사 이름이 Doris and Bertie입니다. 당연히 버핏의 누이들이 만든 회사는 아니고, 글쓰기 교육, 컨설팅 등을 하는 회사인데, 버핏의 유명한 말을 인용해서 회사를 차린 것이죠. 버핏이 글쓰기가 어렵다면 Doris and Bertie으로 시작해 보세요라고 했으니 많은 이들의 기억에 남았을 것이고 그런 기회를 잡은 것입니다. 정말 대단한 분들이죠.

https://www.dorisandbertie.com/

함경도찹쌀순대

열이아빠 — Thu, 9 Apr 2026 15:09:36 +0900

3호선 가락시장역과 경찰병원 역 사이에 있습니다. 경찰병원역이 좀 더 가깝지만 큰 차이는 없어 보입니다.

24시간 영업한다고 합니다. 이전에 24시간 영업하던 곳들이 코로나 시절을 지나면서 야간 영업이 없어지긴 했는데, 이곳은 지금도 24시간입니다. 평일(목요일) 점심시간에 방문했는데, 약간의 웨이팅이 있습니다. 독특하게 웨이팅 라인이 식당 안쪽부터 시작됩니다. 계산대를 중심으로 출입구로 늘어지는 라인입니다. 식당 안쪽 웨이팅 기준으로 대략 15명 정도 서있는데, 줄이 빠지는 것은 5-10분 정도입니다. 보기보다 좌석이 많아서 빨리 빠집니다. 식당 안쪽 웨이팅만 있다면 기다리는 것도 나쁘지 않습니다.

그리고 1명이나 2명은 더 빨리 좌석이 납니다. 그래서 줄을 서 있다가 1명이요, 2명이요~라고 부르면 재빨리 나가서 자리를 잡으면 됩니다. 1인석이 따로 있는 건 아니지만 제가 앉은자리는 맞은편 의자가 없네요. 벽이라서 그런가.

https://naver.me/5RhdzW4j

네이버지도

함경도찹쌀순대

map.naver.com

보통은 순댓국(특)이 있는데, 여기는 없습니다. 정식은 있지만 순댓국은 그냥 순대국이네요. 정식을 주문할까 하다가 정식 가격이 올랐다는 안내를 보고, 망설이다가 그냥 순대국을 주문했습니다. 옆자리에 정식을 주문한 것을 보니 4000원 차이가 날 정도는 아니지 않나 싶지만, 수육과 여러 종류의 순대가 궁금하다면 정식도 괜찮을 것 같네요.

순대국은 진한 국물입니다. 따로 요청을 하지 않으면 순대와 고기가 섞인 상태인데, 순대보다는 고기가 많습니다. 순대가 있었나 싶을 정도로 고기가 많네요. 간혹, 순대가 질긴 경우가 있는데, 여기는 순대가 사르르 녹는 스타일입니다.

반찬은 리필입니다. 자리에 다대기나 들깻가루가 없는데, 들깨가루도 필요하면 리필 코너에서 가져오는 것이라고 하더라구요. 기본 국물이 나쁘지 않아 들깨가루 생각은 따로 나지 않았습니다.

* 업데이트 (정식 추가)

다음 날 원래는 IT 벤쳐타워 지하에 있는 가락토담순대에 가려고 했는데, 상호명이 바뀌었고 순댓국 메뉴가 사라져서, 또 다시 방문.

정식 주문 시에는 고추, 쌈장, 소금이 추가로 나오고 정식 메뉴가 나옴. 보통은 두 명이 와서 한 명은 정식, 한 명은 순댓국을 주문하는데, 시간이 좀 넉넉하다면 혼자 주문해도 괜찮음. 어제는 4천원이면 좀 애매하네 싶었는데, 이 정도 양과 질이면 충분히 수용.

아무리 흐린 먹물이라도 가장 훌륭한 기억력보다 낫다.

열이아빠 — Thu, 9 Apr 2026 13:14:23 +0900

'실용주의 프로그래머'에 인용된 문구라고 합니다. 한국어 번역문이 서평이나 블로그 글에 실리면서 많이 인용되는 것 같습니다.

영어 원문은 아래와 같습니다.

The palest ink is better than the best memory.

20세기 초에 중국에서 활동한 선교사가 쓴 책을 통해 처음 영어로 번역되었다고 합니다. 아서 헨리 스미스(Arthur H. Smith)의 책 'Proverbs and Common Sayings from the Chinese'에 쓰인 표현은 아래와 같습니다. 아마 이 문장이 간단하게 줄어들면서 '실용주의 프로그래머'에 인용된 영문 표현이 된 것 같습니다.

The palest ink is better than the most capricious memory

중국에서 사용하는 표현도 속담이다 보니 원본 출처가 있는 것은 아니고 여러 형태로 변형되어 전해집니다. 가장 많이 쓰이는 것은 아래와 같습니다.

好記憶不如赤筆

한국어로 풀어보면 "좋은 기억력도 직접 쓴 글씨만 못하다"입니다. 한자 표현 중에서 마지막 赤筆(적필)은 붓으로 직접 적은 글씨나 메모를 뜻한다고 합니다. 많은 이들이 이 속담을 인용하면서 희미한 잉크라는 표현 때문에 "기록"이 중요하다고 표현하는데, 중국에서는 그보다 손으로 직접 쓴 글에 초점을 맞추고 있습니다. 희미한 잉크라는 것은 쓴 글이 희미해지는 그런 상황을 표현하는데, 원래 중국 속담은 글을 쓰는 도구에 초점을 맞추고 있습니다. 이렇게 블로그에 남기는 글 따위가 아니라 직접 글을 쓰면서 남기는 것이 중요하다는 것입니다.

또 다른 표현으로 好记性不如烂笔头 가 있는데, 여기서 烂笔头(란필두)는 직역하면 '다 닳아빠진 짧은 붓'의 의미라고 합니다. 아마 흐린 먹물(palest ink)이라는 표현은 이를 해석한 것이 아닌가 싶습니다.

열이아빠의 어쨌거나 저쨌거나

2026년 6월 테크니컬 라이팅 이런 저런 소식

6월 10일

2026년 5월 테크니컬 라이팅 이런 저런 소식

5월 6일

5월 8일

5월 11일

5월 18일

5월 26일

5월 28일

5월 29일https://www.reddit.com/r/technicalwriting/comments/1toxdnu/bye/

크롬에서 pdf를 열고 복사를 했는데, 숫자와 기호가 분리되는 현상

전주콩뿌리콩나물국밥 미금점

AI The Docs 2025 - AI 에이전트에 대한 쉬운 설명

AI The Docs 2025 - 작업 맥락과 Affordances을 고려한 개발자 포털

정보시스템 감리수행가이드에서 배우는 글쓰기

이렇게 상상하면 아주 쉽다 .

함경도찹쌀순대

아무리 흐린 먹물이라도 가장 훌륭한 기억력보다 낫다.

5월 29일
https://www.reddit.com/r/technicalwriting/comments/1toxdnu/bye/