본문 바로가기

전체 글

(2685)
정보시스템 감리수행가이드에서 배우는 글쓰기 자료는 NIA(한국지능정보사회진흥원) 게시판에서 받을 수 있습니다.https://www.nia.or.kr/site/nia_kor/ex/bbs/View.do?cbIdx=99860&bcIdx=24365&parentSeq=24365 내용 중 75페이지 "2. 감리계획서 및 감리보고서 작성 원칙"에 보고서를 작성하는 원칙과 정확한 글쓰기에 대한 설명이 포함되어 있습니다. 공문서 작성 원칙 등의 문서를 참고한 것이라고는 하지만, 정보시스템이라는 환경에 맞게 예문과 설명을 추가했으니, IT 분야에서 기술 문서를 작성할 때 참고할만한 내용입니다. 문서의 특성상 명확하지 않은 내용으로 작성된 경우 분쟁이 생길 수 있습니다. 프로젝트 규모에 따라 감리 비용은 억대가 넘어가는 경우도 많아 감리보고서의 중요성은 더 말할 필..
이렇게 상상하면 아주 쉽다 . 2018년 게시된 "[정혁준의 비즈니스 글쓰기] 글 쓸 때도 사람이 먼저다" 기사 일부입니다.“나는 누이들에게 말하고 있다고 가정하면서 버크셔해서웨이 연례 보고서를 작성한다 . 이렇게 상상하면 아주 쉽다 . 내 누이들은 대단히 명석하지만 재무나 회계 분야는 잘 알지 못한다 . 쉽게 쓴 내용은 이해할 수 있지만 전문용어가 나오면 어리둥절해질 것이다 . 그래서 나는 누이들이 알고 싶어 할 정보를 전달하는 것을 목표로 보고서를 쓴다 . 내게는 셰익스피어처럼 글을 써야 할 이유가 전혀 없다 . 오로지 상대방이 원하는 정보를 주고자 하는 진실한 열망만이 필요할 뿐이다 .”‘투자의 달인’이라는 워런 버핏 버크셔해서웨이 회장이 미국증권거래위원회(SEC)가 1998년 펴낸 (A Plain English Handbook..
함경도찹쌀순대 3호선 가락시장역과 경찰병원 역 사이에 있습니다. 경찰병원역이 좀 더 가깝지만 큰 차이는 없어 보입니다.24시간 영업한다고 합니다. 이전에 24시간 영업하던 곳들이 코로나 시절을 지나면서 야간 영업이 없어지긴 했는데, 이곳은 지금도 24시간입니다. 평일(목요일) 점심시간에 방문했는데, 약간의 웨이팅이 있습니다. 독특하게 웨이팅 라인이 식당 안쪽부터 시작됩니다. 계산대를 중심으로 출입구로 늘어지는 라인입니다. 식당 안쪽 웨이팅 기준으로 대략 15명 정도 서있는데, 줄이 빠지는 것은 5-10분 정도입니다. 보기보다 좌석이 많아서 빨리 빠집니다. 식당 안쪽 웨이팅만 있다면 기다리는 것도 나쁘지 않습니다. 그리고 1명이나 2명은 더 빨리 좌석이 납니다. 그래서 줄을 서 있다가 1명이요, 2명이요~라고 부르면 재..
아무리 흐린 먹물이라도 가장 훌륭한 기억력보다 낫다. '실용주의 프로그래머'에 인용된 문구라고 합니다. 한국어 번역문이 서평이나 블로그 글에 실리면서 많이 인용되는 것 같습니다.영어 원문은 아래와 같습니다.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 중국에서 사용하..
조지프 캠벨의 살아있음의 경험과 테크니컬 라이팅 미국의 신화학자 조지프 캠벨(Joseph Campbell)이 이야기한 ‘살아있음의 경험(The Experience of Being Alive)’은 스토리텔링에 있어서 아주 중요한 요소로 언급되곤 합니다. 하지만 스토리 중심의 이야기와 다르게 테크니컬 라이팅은 이 개념이 큰 도움이 되지 않을까 해서 구글 AI와 이야기(?)하다가 좋은 조언을 남겨주어서 이를 옮겨보고자 합니다.물론 일반적인 테크니컬 라이팅의 기본에 조셉 캠벨을 살짝 맞추어놓은 것 같은 느낌이 없지는 않지만, 누군가에게 테크니컬 라이팅을 이야기할 때 설명하기에는 나쁘지 않을 것 같네요. 조지프 캠벨의 '신화의 힘'에서 다루는 개념인데, 이 책은 현재 일시 품절 상태입니다(2020년 출간인데, 출판사 사정 때문인 것 같기도 하고. 중고 서점을..
2026년 4월 테크니컬 라이팅 이런 저런 소식 4월 2일AI 검색에 인용되는 기술 문서의 조건https://insight.infograb.net/blog/2026/04/01/ai-docs/인포그랩 테크니컬 라이터 Grace(박민영) 님의 글입니다. 중간에 llms.txt에 대한 설명도 나오는데 인포그랩에서는 아래와 같이 사용하고 있네요.https://insight.infograb.net/llms.txt 오라클, 3만 명 해고 단행https://news.hada.io/topic?id=28072전 세계 직원 약 2만~3만 명(전체의 18%) 이 화요일 오전 6시 이메일 한 통으로 해고 통보를 받았다고 합니다. 래딧에 5주전에 입사한 시니어 테크니컬 라이터가 자신도 대상이 되었다는 글을 올렸네요.https://www.reddit.com/r/technica..
WTD 베를린 2025 - 라이트닝 토크 둘째 날 Comedy and technical writing - Adrian Doonan 발표자는 2019년(아마 이전에는 PM)부터 테크니컬 라이터를 시작했고 즉흥연기(Improvisation/Improv)도 비슷한 시기에 시작했다고 합니다. 아마 스탠드업 코미디 비슷한 것을 하는 것 같은데 즉흥연기와 테크니컬 라이팅의 비슷한 부분에 대한 이야기입니다. 1. 너무 어렵게 고민하지 말고 쓰세요. 뭔가 떠오르면 그대로 쓰고 당장 떠오르지 않는 것을 고민하지 마세요. 2. (note에 대한 이야기였는데 어떤 의미인지 모르겠네요 ㅠㅠ) 3. 상대방의 이야기를 경청하세요. 즉흥연기에서는 상대방의 연기에 맞추어 주는 것이 중요한데, 테크니컬 라이터도 개발자나 누군가와 이야기할 때 그들의 이야기를 듣고 적절하게 반응해 주..
Hello Word Ping Pong Electron 튜토리얼을 따라가고 있습니다. 요즘은 그냥 AI의 도움을 받아서 개발(?)할 수도 있지만, 고전적인 방법을 선택하고 있습니다.https://www.electronjs.org/docs/latest/tutorial/tutorial-preload#communicating-between-processes 아직은 시작 단계라 큰 어려움 없이 따라가고 있었는데 Communicating between processes라는 단계에서 지정한 텍스트("pong")가 표시되지 않고 있습니다. 혹, 코드 실수가 있었나 살펴보긴 했는데, 코드 실수는 아닌 것 같구요. 이것저것 살펴보다가 결국에는 ChatGPT에게 물어보았습니다. 몇 가지 케이스를 제시해주고 있는데 가장 흔한 실수(라기보다는 개념을 몰라서)가 콘..

반응형