2-7. In-class (2)

Google Technical Writing Course - 2

by 잡초

Exercise 2: Illustrating


Google Drawings를 이용해서 다이어그램 그리기 실습.

(*Google Drawings 링크 : https://drawings.google.com/)

감사히도 이번 실습은 Bad/Good diagram의 예시도 나와 있다.


다이어그램은 하기 문단의 내용을 포함하면 된다:


When the Domain Name Server (DNS) resolver first receives a request from a client, it asks the Root Server about what Top Level Domain (TLD) server it should talk to next. The Root Server replies to the resolver with the location of the relevant TLD server.


먼저, 아래는 내가 만든 다이어그램.


tw28.JPG


도식화하고 나서 예시들을 보니, 너무 단순하게 그렸는가 싶었는데, 자세히 보니 instruction이 별도로 있었다. 아래 Context이다:


Context

Assume that the document has already defined the following:

Top Level Domain (TLD): The end of the website's main address, for instance ".com" or ".net".

TLD server: A server with information on servers associated with the specified TLD.

Root Server: A server with information on TLD server locations.

Preceding Paragraph:

Every time a client queries their browser for a website, the browser must forward the request to the appropriate IP address. To do this the browser looks for the IP address using a Domain Name Server (DNS). A DNS uses a resolver to query multiple servers for information on the IP address.


이 내용도 한 번에 이해가 안되어서 챗GPT한테 물어봤는데,

우선 Preceding Paragraph의 마지막 문장의 "query multiple servers"가 한 번에 여러 서버에 물어본다는 뜻이 아니라, 문제에 제시된 단계에 따라 여러 서버들을 순서대로 컨택하여 필요한 응답을 받는다는 뜻이었다.


DNS 조회는 실제로 아래와 같은 여러 서버 단계를 거친다고 한다.


1. DNS Resolver (클라이언트 브라우저 쪽에 있음)

2. Root Servers (13개의 이름이 지정된 루트 서버 그룹 → 실제론 수백 대로 분산됨)

3. TLD Servers (.com, .org, .net 등)


4. Authoritative Name Servers (도메인에 대한 실제 IP 주소를 보유)

→ 이 부분에 대한 설명은 없으나, 예시에서는 "Example Server"로 표시되어 있다.

→ 내가 만든 도표에서는 설명이 없어서 빠졌으나, 컴퓨터공학/네트워크 관련 전공의 학생이라면 자연스럽게 포함시키지 않을까 싶다.


문제에서 제시된 내용 기반으로만 Diagram을 다시 만들어봤을 때, 아래와 같다.


tw32.JPG


그렇다면 이제 문제에서 제시된 예시들을 살펴보자.


먼저 Bad Example부터 살펴보면, 아래와 같다.


tw30.JPG


아무런 의미 없이 도형의 크기와 색을 다르게 해서 어지럽다.

Flow가 왼쪽 → 오른쪽이 아닌 오른쪽 → 왼쪽이라 헷갈린다.

DNS Resolver의 오른쪽은 양방향 화살표, 왼쪽은 단순 직선이라 무엇을 표현하고자 하는지 알 수 없다.

DNS Resolver는 Root Server로부터 정보를 받아 직접 TLD Server에 컨택하지만, 위 도표에서는 TLD Server가 Root Server와 연결되어 있다.

DNS Resolver는 TLD Server로부터 받은 정보를 기반으로 직접 Example Server에 컨택하지만, 위 도표에서 Example Server는 TLD Server와 연결되어 있다.


그 다음은 Good Example.


tw31.JPG


위에서 언급한 부분이 모두 보완되었다. 그 외에도 아래와 같은 점들이 부각된다:

화살표에 무엇이 오가는지 명시되어 있음.

숫자로 순서가 명확히 표기됨.

Client 그림을 통해 example.com의 의미를 초보자도 쉽게 이해할 수 있게함.


추가로, 아래와 같은 Direction이 있다.


Directions

Simplify this diagram to only represent the subset of steps in the below paragraph. You may also start from scratch.


여기서 below paragraph가 exercise 문제이고, 위 그림에서 빨간색 네모친 부분이다.

내가 그린 도식도가 결국 Flow 상에서는 맞는 셈.

다만 그림을 사용해서 이해도를 높이거나, 화살표에 실제로 오가는 예시를 들었으면 더 좋았을 것이다.





참고로 아래는 챗GPT가 그린 도식도.

...할말하않.




출처 : https://developers.google.com/tech-writing/twol/illustrations

keyword
매거진의 이전글2-6. In-class (1)