본문 바로가기

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

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

반응형

7월 10일

벌써 7월이네요 ㅠㅠ

Transforming Developer Experience: A New Era for Twilio's Documentation

https://www.twilio.com/en-us/blog/new-era-for-twilio-documentation

twilio에서 문서화 플랫폼을 전환한 경험을 공유합니다. 5000페이지와 2만여 개 정도의 샘플 코드를 새로운 플랫폼으로 전환했다고 합니다. "새로운"이 중요한 것이 아니라 장기적으로 개발자, 사용자와 소통하고 프로세스에 따라 작업할 수 있는 환경으로 전환했다는 것이 중요한 듯합니다.

문서화 시스템에 남아있던 기술적인 부채를 정리하면서 로딩 성능이 좋아졌고 샘플 코드를 테스트하고 관리하는 부분도 개선되었다고 하네요.

 

 

찾아보니 2016년에도 튜토리얼 문서를 개선한 경험에 대해 공유한 내용이 있네요. 그래서 Before, After 비교한 이미지가 그냥 디자인만 바뀐 거 아니야라는 느낌입니다.

https://www.twilio.com/en-us/blog/tutorials-the-new-documentation-experience-from-twilio-html

 

7월 15일

Writebook 라는 웹 출판 도구입니다. 무료로 제공되구요. Basecamp라는 서비스로 잘 알려진 37signals에서 개발한 소프트웨어라고 합니다. 이력을 보니 지난달에 공개를 했구요. 100% 무료로 제공됩니다.

https://once.com/writebook

 

독특한 건 SaaS에 반대하며 셀프 호스팅에 최적화된 소프트웨어를 만들기 위해 ONCE라는 것을 만들었고 그 중 하나가 Writebook이라는 겁니다. 37signals은 2023년 클라우드를 사용하지 않고 공유 데이터 센터에 직접 하드웨어를 호스팅하기로 결정했다고 합니다. 아마 ONCE도 그런 흐름에서 나온 결정이 아닌가 싶습니다.

https://basecamp.com/cloud-exit

 

7월 19일

Import and export Markdown in Google Docs

https://workspaceupdates.googleblog.com/2024/07/import-and-export-markdown-in-google-docs.html

지난 16일 구글 문서에서 마크다운 형식의 가져오기, 내보내기를 지원한다는 발표를 했습니다. 이전에도 일부 마크다운 기능을 지원하긴 했는데 이를 좀 더 확장한 것입니다. 테크니컬 라이터에게는 별로 매력적인 기능은 아니라고 생각했는데 커뮤니티에 올라온 이야기를 살펴보면 테크니컬 라이터가 아닌 구성원이 문서를 작성할 때 마크다운에서 바로 작성하는 것을 부담스러워 하는 경우가 있다고 합니다(특히 개발자가 아닌 경우). 그래서 구글 문서에서 평소처럼 문서를 작성하고 마크다운으로 내보내서 처리하는 방식이 매력적일 수 있다고 하네요.

 

7월 31일

[AI Report 2024-1] 2024년 AI 이슈를 용어와 함께 쉽게 이해하기

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

지난 25일 올라온 자료입니다. 한국지능정보사회진흥원(NIA)에서 공개한 간행물인데요. AI 관련 용어들을 알기쉽게 정리했습니다. 자료는 로그인 없이 바로 내려받을 수 있습니다.

 

인상적인 점은 각각의 용어에 대해 5가지 항목으로 설명을 해주고 있습니다.

(1) 왜 나오게 되었나?

(2) 쉽게 설명하면?

(3) 예시와 함께 좀 더 자세히 알아볼까?

(4) 왜 중요한가?

(5) 어디에 활용되는가?

 

아쉬운 점은 인쇄물 용도로 만든 자료라 눈에 딱 들어오지 않는다는 ^^

728x90