5개의 주제로 라이트닝 토크를 진행합니다. 예전에는 라이트닝 토크를 한 개씩 따로 올렸는데, 요즘에는 그냥 영상 하나로 올리고 있습니다.
How to win over someone else’s users (with docs) - Jill Osborne
미국 소프트웨어 회사 Imply(임플라이)의 테크니컬 라이터입니다. 국내에서도 당근마켓 등에서 데이터 분석, 시각화를 위한 도구로 사용한다고 합니다. Lumi라는 이름의 새로운 제품을 출시했는데, 이 제품의 주요 타깃은 기존에 Splunk를 사용하는 대상이었고, 때문에 제품에 대한 문서가 바닥부터 설명하는 것이 아니라 해당 타깃 독자에 맞추어 작성되어야 함을 의미합니다(발표자의 표현에 따르면 자연스럽게 다음 단계처럼 느껴지게 만들었어야 했다고 합니다).
I want your wholesome self promotion - Daniel
Daniel은 WTD 슬랙 커뮤니티 운영팀에 참여하고 있습니다. 운영팀의 역할 중 하나가 스팸이나 상업적인 게시물을 삭제하는 것인데 가끔 의도와 다르게 상업적인 홍보 게시물로 오해받는 경우가 많다고 합니다(물론 홍보 게시물이지만, 좋은 정보를 담고 있는 경우도 있어서 하는 이야기 같네요). 그래서 무언가 알리고 싶을 때는 다음과 같은 순서로 내용을 설명하라고 합니다.
- What is it? 알리고 싶은 주제가 무엇인가요?
- Who made it? 이 제품(또는 무언가)은 누가 만든 것인가요?
- Why did you do it? 왜 이 이야기를 하려고 하나요?
- What did you learn? 어떤 배움을 얻을 수 있나요?
- What are you proud of? 어떤 점을 강조하고 싶은가요?
- What were your constraints? 어떤 문제를 해결해 주나요?
그리고 자신만의 문체로 글을 쓰라고 합니다. 너무 상업적이거나 AI 스러운 냄새가 나지 않도록이요.
Making Documentation Testable: A Static Analysis Approach - Roman Krivtsov
정적 문서 품질 도구인 Ducku에 대해 이야기입니다. 발표자는 해당 프로젝트의 컨트리뷰터입니다.
https://github.com/duckuio/ducku_cli
발표자 이야기로는 실제 몇몇 대규모 프로젝트에서 사용한 도구이고 이를 오픈소스로 공개했다고 합니다. 아직은 별이 21개 정도이니, 그리 잘 알려진 프로젝트는 아니네요.
프로젝트 README에서 독특하게 간단한 제품 소개 뒤에 첫 번째로 나오는 것이 Use Cases입니다. 실제 어떻게 활용할 수 있는지 먼저 보여주고 그다음에 어떻게 쓰는지 알려주겠다는 전략인 것 같습니다(보통은 제품 소개 다음 설치부터 시작하죠).
What makes a good French croissant? - Ariel Kaiser
진짜 제목처럼 맛있는 프랑스식 크루아상을 찾는 방법에 대한 공유입니다. 크루아상은 냉동 생지 형태로도 판매되어 집에 에어프라이어나 오븐만 있으면 쉽게 만들 수 있는데, 그렇게 만든 것은 제대로 만들어진 크루아상이 아니라는 이야기입니다. 프랜차이즈도 마찬가지구요.
사회자가 La Maison Berlin 크루아상을 먹어보았냐고 물어보는데, 베를린에서 유명한 크루아상 가게라고 합니다.
https://www.writethedocs.org/conf/berlin/2025/visiting/
https://www.lamaison.berlin/en/
Translating Through Domains in Documentation - Esteban Landerreche
Roseman Labs라는 회사에서 엔지니어로 일하고 있습니다. 제품 사용자가 데이터 과학자처럼 전문적인 기술 배경을 가진 사용자도 있고 데이터 보호 담당자처럼 기술적인 배경이 별로 없는 이들도 있는데, 이 두 가지 사용자층을 만족시킬 수 있는 문서를 어떻게 작성해야 하는지 고민이라고 합니다. 많이 다루어졌던 주제지만, 딱히 정답은 없는 주제이기도 합니다. 발표자 역시 자신만의 해결책이 아니라 이런 고민을 가지고 있고 이에 대해 많은 이들과 이야기를 나누어보고 싶다는 이야기를 던집니다.
https://docs.rosemanlabs.com/latest/index.html#
https://youtu.be/lgBbeUFoSic?si=6iMWwISAjziHNlZh
