잡초

2-8. In-class (4) - Google Technical Writing Course - 2

잡초 — Sat, 05 Jul 2025 02:05:52 GMT

Exercise 4: Tutorials 프로그래밍 언어 하나를 선택해서 `for` loops에 대한 튜토리얼 작성하기. 스니펫을 적절히 활용하고, 타겟 독자는 다음 중 하나를 고른다. 프로그래밍 언어에 대해 처음 접하며 아직 loops에 대해 모르는 학생들. 하나 이상의 프로그래밍 언어를 알고 있으며, 해당 프로그래밍 언어를 새로 배우는 학생들. 예를

2-8. In-class (3) - Google Technical Writing Course - 2

잡초 — Wed, 02 Jul 2025 04:00:07 GMT

Exercise 3: Descriptions Describe the appearance of a thumbtack (not a pushpin) without using mathematical measurements, illustrations, or photographs. Thumbtack (not a pushpin)의 생김새 묘사하기. 참고로 Thumb

2-7. In-class (2) - Google Technical Writing Course - 2

잡초 — Tue, 01 Jul 2025 12:11:05 GMT

Exercise 2: Illustrating Google Drawings를 이용해서 다이어그램 그리기 실습. (*Google Drawings 링크 : https://drawings.google.com/) 감사히도 이번 실습은 Bad/Good diagram의 예시도 나와 있다. 다이어그램은 하기 문단의 내용을 포함하면 된다: When the Domai

2-6. In-class (1) - Google Technical Writing Course - 2

잡초 — Sun, 29 Jun 2025 07:30:20 GMT

Course1과 마찬가지로 특별히 답안이 있는게 아니라, 라이브 세션으로 진행하면서 서로 의견을 나누는 실습활동. 다만 Course1보다 난이도가 조금 높아서 첨삭이라도 받고 싶은데, 당장은 수가 없으니... 이번에도 챗GPT의 도움을 받기로 했다. 우선 먼저 시도해보고, 챗GPT한테 모범답안을 달라고 하기. Exercise 1: Writing is R

[Intro] 이걸 왜?

잡초 — Fri, 27 Jun 2025 04:00:04 GMT

Technical Writing에 관심을 갖게 되었지만, 당장 뭘 해야 할지 막막한 상황에서 한 글을 보게 되었다. 라인 Technical Writer분이 작성하신 글로, 제목은 '그것이 알고 싶다 - 왜 개발자는 글을 못 쓸까?'. https://engineering.linecorp.com/ko/blog/why-are-engineers-so-bad-at

2-5. Creating sample code - Google Technical Writing Course - 2

잡초 — Tue, 24 Jun 2025 10:00:52 GMT

code라는 단어를 보자마자 약간 겁먹었는데, 결국 ‘좋은 샘플 코드를 작성하는 법’이었다. 모든 Technical Writing이 개발 분야에 국한된 건 아니겠지만... 백문이불여일견이라고, 어느 필드이건 ‘좋은 코드’ 역할을 하는 샘플이 있을 테니 그걸 잘 작성하고 활용하는 것이 중요할 것 같다. 목차는 아래 ‘좋은 샘플 작성법’을 하나씩 설명하는

2-4. Illustrating - Google Technical Writing Course - 2

잡초 — Tue, 24 Jun 2025 04:00:04 GMT

문서에서 그림을 활용하는 법에 대한 파트로, 목차는 아래와 같다. Write the caption first 캡션(caption)이란 그림 밑에 조그맣게 달리는 설명 문구로, 그 그림에 어떤 설명을 붙일지를 먼저 생각해보라는 뜻. 즉 글의 흐름에 맞춰 어떤 이미지가 들어가야 하는지를 먼저 생각한 후에 맞는 그림을 넣으라는 의미다. 좋은 캡션은 아

2-3.Organizing large documents - Google Technical Writing Course - 2

잡초 — Sun, 22 Jun 2025 21:49:30 GMT

방대한 정보들을 응집력 있는 문서나 웹사이트로 구조화하려면 어떻게 해야 할까? 혹은 이미 산발적으로 흩어져있는 문서나 웹사이트를 보다 접근하기 쉽고 유용하게 바꾸려면 어떻게 해야 할까? 아래 목차는 그에 대한 팁이다. When to write large documents 많은 양의 정보를 정리할 때는 하기 2가지 선택지가 있다. 하나의 긴 문서

2-2. Self-editing - Google Technical Writing Course - 2

잡초 — Sat, 21 Jun 2025 01:29:30 GMT

퇴고하는 법에 다루고 있다. 목차는 아래와 같다. Adopt a style guide 일반적인 회사나 조직, 또는 일정 규모 이상의 오픈소스 프로젝트는 이미 존재하는 각자의 style guide가 있다. Style Guide에 대해 접해본 적이 없다면, Google Developer Documentation Style Guide를 먼저 보고 올 것

2-1. Objectives - Google Technical Writing Course - 2

잡초 — Fri, 20 Jun 2025 23:55:25 GMT

Technical Writing Course Two는 One의 심화과정에 해당하는 강좌로, 선수과목으로 Technical Writing Course one을 보고 올 것을 추천하고 있다. Two에서 다루는 내용들은 아래와 같다. One이 기초적인 문법이나 문장, 그리고 짧은 단락 위주를 다루었다면 Two에서는 더 긴 문서에 대해서, 그리고 보다 세부적

1-11. In-class - Google Technical Writing Course - 1

잡초 — Fri, 20 Jun 2025 22:58:16 GMT

proximity to the knowledge In-class는 라이브로 진행되는 실습으로, 실제로는 제시된 문제에 대해 각각의 생각을 나누는 자리라고 한다. 아쉽게도 지금은 라이브 세션이 끝나서 그 기회가 없지만, 나중에라도 혹시 라이브에 참여할 경우에 대비해서, 그리고 무엇보다 나중에 다시 봤을 때 어떻게 생각이 바뀌어 있을지 궁금해서 혼자 진행한

1-10. Punctuation - Google Technical Writing Course - 1

잡초 — Fri, 20 Jun 2025 06:59:40 GMT

다양한 구두점에 대한 이야기. 아래 내용들을 다룬다. Commas 여기서 다루는 콤마의 역할은 크게 3가지이다. 1. 문장의 호흡 조절 (pause) 2. 항목들 간의 구분 (embedded lists) 3. 구절간 구분 (조건문, 간단한 정의나 여담 등) 2번의 경우, 마지막 항목 앞에 붙는 serial comma (oxford comma)에

1-9. Documents - Google Technical Writing Course - 1

잡초 — Fri, 20 Jun 2025 03:08:08 GMT

총체적인 문서 쓰는 법. 이번 파트의 목차는 아래와 같다. State your document's scope 좋은 문서는 아래처럼 이 글에서 다룰 내용(scope)를 정의하며 시작한다. This document describes the design of Project Frambus. 더 좋은 문서는 이 글에서 다루지 않을 내용(non-scope)

Known Unknowns - "우리가 모른다는 사실을 알고 있는 것들"

잡초 — Fri, 20 Jun 2025 03:06:33 GMT

미국 국방부장관 도널드 럼즈팰드의 연설에서 유래한 것으로, 정보를 다룰 때 무엇을 알고 무엇을 모르는지 구분하는 유용한 사고틀이다. 이는 후에 철학, 심리학, 정책, 소프트웨어 개발 등 다양한 분야에 영향을 끼쳐, 리스크 분석, 전략적 판단, 기술 문서 작성, 기획 등에서 불확실성을 체계적으로 정리하는데 활용된다. "There are known know

1-8. Audience - Google Technical Writing Course - 1

잡초 — Thu, 19 Jun 2025 21:26:49 GMT

글을 읽을 독자층을 정의하고, 그들이 무엇을 얻어갈지 정하며, 얻어갈 수 있도록 그들에게 맞춘 문서를 만드는 법에 대해 다루는 파트. good documentation = knowledge and skills your audience needs to do a task − your audience's current knowledge and skills 즉

1-7. Paragraphs - Google Technical Writing Course - 1

잡초 — Wed, 18 Jun 2025 09:08:20 GMT

단락에 대한 이야기. 목차는 아래와 같다. Write a great opening sentence 첫 문장에 단락의 주제 담기. Technical Writing 뿐만 아니라, 어느 글쓰기 책이나 수업에서도 강조하는 내용. 하지만 막상 그렇게 쓰거나 고치려고 하면 쉽지만은 않아서, 연습이 많이 필요한 부분. 그런 이유로, 바로 Exercise로 넘어간

1-6. Lists and tables - Google Technical Writing Course - 1

잡초 — Tue, 17 Jun 2025 21:47:53 GMT

이전까지 문법이나 어휘를 비롯한 문장 그 자체에 집중했다면 이번부터는 보다 시각적인 기술들에 대해 다룬다. 목차는 아래와 같다. Choose the correct type of list Technical Writing에서 주로 사용하는 리스트의 종류에는 아래 3가지가 있다. Bulleted lists Numbered lists Embedded

1-5. Short sentences - Google Technical Writing Course - 1

잡초 — Tue, 17 Jun 2025 00:12:20 GMT

앞서 다룬 '명료성'에 이어 또 다른 중요한 요소인 '간결성'에 대한 이야기. 목차는 아래와 같다. Focus each sentence on a single idea 하나의 문장에는 하나의 주제만 담기. 아래 예시가 있다. The late 1950s was a key era for programming languages / because IBM i

1-4. Clear sentences - Google Technical Writing Course - 1

잡초 — Sun, 15 Jun 2025 10:11:43 GMT

Technical Writing에서 가장 중요한 항목 중 하나인 "clarity (명료성)"에 대한 내용. 목차는 아래와 같다. Choose strong verbs Weak Verb 대신 Strong Verb를 사용할 것. Weak Verb의 대표적인 예시는 be동사 / occur / happen 등이 있으며, 이를 아래와 같이 Strong Verb

1-3. Active voice - Google Technical Writing Course - 1

잡초 — Sat, 14 Jun 2025 22:51:37 GMT

능동태와 수동태에 대한 내용. 한글과 달리 영어에서는 수동태를 많이 쓰는 줄 알았는데 여기서는 영어에서도 수동태보다는 능동태를 사용할 것을 권장하고 있다. 목차는 아래와 같다. 앞 부분은 기초적인 문법이라, 각각의 파트에서 다루는 내용을 짧게 요약만 해두었다. 태(voice)에 대해 보다 자세한 내용이 알고 싶다면, 글 맨 하단에 첨부한 링크에서 확