1-5. Short sentences

Google Technical Writing Course - 1

앞서 다룬 '명료성'에 이어 또 다른 중요한 요소인 '간결성'에 대한 이야기.

목차는 아래와 같다.

Focus each sentence on a single idea

하나의 문장에는 하나의 주제만 담기.

아래 예시가 있다.

The late 1950s was a key era for programming languages / because IBM introduced Fortran in 1957 and / John McCarthy introduced Lisp the following year, / which gave programmers both an iterative way of solving problems and a recursive way.

→ The late 1950s was a key era for programming languages. IBM introduced Fortran in 1957. John McCarthy invented Lisp the following year. Consequently, by the late 1950s, programmers could solve problems iteratively or recursively.

그런데 두 번째는 너무 딱딱 끊어져서 오히려 가독성이 떨어진다는 느낌이 드는건, 내가 익숙하지 않아서일까?

어쨌든 바로 다음, Exercise로 넘어가보았다.

Exercise

In bash, use the if, then, and fi statements to implement a simple conditional branching block in which the if statement evaluates an expression, the then statement introduces a block of statements to run when the if expression is true, and the fi statement marks the end of the conditional branching block.

→ In bash, use an if, then, and fi statement to implement a simple conditional branching block. The if statement evaluates an expression. The then statement introduces a block of statements to run when the if expression is true. The fi statement marks the end of the conditional branching block.

여기서 if / then / fi를 각각 리스트화하면 더 낫지 않을까 싶다.

아니나다를까, 바로 다음 주제가 긴 문장을 리스트화하는 것이다.

Convert some long sentences to lists

"or"로 연결된 긴 문장이 있다면, bulleted list로 전환하는 것을 고려해볼 것.

또는 여러 항목이나 행위가 나열되어 있다면, bulleted 또는 numbered list로 전환해볼 것.

예시는 아래와 같다.

To alter the usual flow of a loop, you may use either a break statement (which hops you out of the current loop) or a continue statement (which skips past the remainder of the current iteration of the current loop).

→ To alter the usual flow of a loop, call one of the following statements:

break, which hops you out of the current loop.

continue, which skips past the remainder of the current iteration of the current loop.

Exercise

1. To get started with the Frambus app, you must first find the app at a suitable store, pay for it using a valid credit or debit card, download it, configure it by assigning a value for the Foo variable in the /etc/Frambus file, and then run it by saying the magic word twice.

비교적 쉽게 했다고 생각했는데, 대명사를 계속 사용하는 등 놓친 부분이 있었다.

내 답안과 다른 모범답안 부분을 빨간색으로 표기했다.

To get started with the Frambus app, follow below instructions.

(→ Take the following steps to get started with the Frambus app:)

1. Find the app at a suitable store.

2. Pay for it(→ the app) using a valid credit or debit card.

3. Download it(→ the app).

4. Configure it(→ the app) by assigning a value for the Foo variable in the /etc/Frambus file.

5. Run it(→ the app) by saying the magic word twice.

반면 2번은 좀 까다로웠는데, 문장 구조를 파악하는 데 애를 먹었기 때문이다.

2. KornShell was invented by David Korn in 1983, then a computer scientist at Bell Labs, as a superset of features, enhancements, and improvements over the Bourne Shell (which it was backwards compatible with), which was invented by Stephen Bourne in 1977 who was also a computer scientist at Bell Labs.

헷갈렸던 포인트는 아래 2가지이다.

1) ...1983, then a computer...

이 구문에서 then이 당연히 접속사라고 생각해서 동사만 열심히 찾았는데, 동사가 없어서 혼란스러웠다. 결론적으로, 여기서 then 은 "그 당시에 ~ 였던"으로 해석되는 부사구로, 앞의 David Korn을 수식한다.

2) ...improvements over the Bourne Shell (which it was backwards compatible with), ...

여기서는 "it"이라는 대명사가 무엇을 가리키는지 헷갈렸다는 점과, "backwards compatible"이라는 단어를 몰랐던 것이 헤맨 이유였다. it은 앞서 나온 KornShell을 가리키며, "backwards compatible (혹은 backwards compatibility)"은 개발에서 자주 쓰이는 단어로 "하위 호환"이라는 뜻이라고 한다.

이렇게 문장의 뜻을 이해하고 아래와 같이 줄글로 풀어썼지만, 문장을 끊어서 의미만 명확히 했을 뿐 여전히 가독성이 썩 좋지는 않다.

KornShell was invented by David Korn in 1983. He was a computer scientist at Bell Labs. KornShell was a superset of features, enhancements, and improvements over the Bourne Shell. KornShell was backwards compatible with Bourne Shell. Bourne Shell was invented by Stephen Bourne in 1977, and he was also a computer scientist at Bell Labs.

따라서 보다 명확히 하기 위해, 이를 리스트화한다.

아래는 모범답안이다.

The following two Bell Labs computer scientists invented popular shells:

Stephen Bourne invented the Bourne Shell in 1977.

David Korn invented the KornShell in 1983.

The KornShell is a backwards-compatible superset of the Bourne Shell, containing many improvements over the older shell.

꼭 원문의 모든 단어 하나하나를 그대로 가져다 쓸 필요는 없다.

아직 나는 틀에 갇혀 있다.

Eliminate or reduce extraneous words

영양가 없는 단어를 필요 이상으로 많이 쓰지 말 것.

아래 예시와 같이 "triggers" 한 단어로 표현할 수 있는 것을 "causes the trigeering of" 처럼 쓰지 말자.

An input value greater than 100 causes the triggering of logging.

→ An input value greater than 100 triggers logging.

또 다른 예시는 아래와 같다.

This design document provides a detailed description of Project Frambus.

→ This design document describes (or details) Project Frambus.

오픽 공부를 하면서도 느꼈지만, 영어에서는 대체로 명사를 쓰려고 하면 무의미하게 문장이 길어지는 것 같다. 동사 하나로 깔끔하게 끝내는 연습을 해야겠다.

아래는 흔히 쓰이는 bloated phrase(과하게 긴 표현)을 깔끔하게 한 단어로 바꾼 표이다.

Exercise

1. In spite of the fact that Arnold writes buggy code, he writes error-free documentation.

→ Although Arnold writes buggy code, he writes error-free documentation.

2. Changing the sentence from passive voice to active voice enhances the clarification of the key points.

→ Changing the sentence from passive voice to active voice clarifies the key points.

3. Determine whether Rikona is able to write code in COBOL.

→ Determine whether Rikona can code in COBOL.

"code" 자체도 동사로 쓰일 수 있다.

4. Frambus causes the production of bugs, which will be chronicled in logs by the LogGenerator method.

→ Frambus produces bugs, which the LogGenerator method logs.

콤마 앞쪽은 쉽게 바꿨는데, 이번에도 뒷 부분이 까다로웠다.

우선 원문은 "method"는 "함수"라는 뜻이고, 버그가 LogGenerator 함수에 의해 로그 파일 안에 기록된다(be chronicled)는 뜻이다.

모범답안에서는 "log"를 "로그로 기록하다"는 능동사로 활용해서 "will be chronicled in logs"를 훨씬 간단하게 줄였다.

Reduce subordinate clauses (optional)

"종속절을 줄여라" - 종속절의 주절(main clause)을 보충해주며, 보통 which / that / because / whose / until / unless / since 와 함께 나온다. 종종 콤마와 함께 쓰이기도 한다. 예를 들어 아래 문장에서 콤마 앞쪽이 주절, 뒤쪽이 종속절이다.

Python is an interpreted programming language, which was invented in 1991.

한 문장에는 하나의 아이디어를 담는다는 원칙에 따라, 종속절이 주절과 별개의 내용을 다룬다면 각각의 문장으로 분리하자. 하지만 종속절이 주절의 의미를 보충설명한다면(extend), 그 종속절은 필요한 요소일 수 있기에 무분별하게 없애지는 않도록 주의하자. 그 연습을 아래 Exercise를 통해서 할 수 있다.

Exercise

1. Python is an interpreted language, which means that the language can execute source code directly.

→ 종속절이 문장의 주제를 보충설명해주기 때문에 삭제하거나 분리하지 않고 내버려둔다.

2. Bash is a modern shell scripting language (1) that takes many of its features from KornShell 88, (2) which was developed at Bell Labs.

→ (1)은 Bash 에 대한 설명이지만, (2)의 경우 약간 다른 주제로 뻗어나가기에 분리해주는 것이 좋다.

3. Lisp is a programming language (1) that relies on Polish prefix notation, (2) which is one of the systems invented by the Polish logician Jan Łukasiewicz.

-> 2번과 마찬가지 이유로 (1)은 유지, (2)는 분리.

4. I don't want to say that Fortran is old, but only radiocarbon dating can determine its true age.-> 이 경우는 빠지면 안되는 쪽이 맞을듯.

Distinguish that from which

미국에서 that은 종속절이 의미상 반드시 필요한 경우에 쓰이는 반면 which는 종속절이 없더라도 무방한 경우 사용된다.

예를 들면,

Python is an interpreted language, which Guido van Rossum invented.

이 경우 파이썬이 누구에 의해 발명되었는가는 이것이 interpreted language인 것과 직접적인 관련은 없다. 따라서 문장 전체의 의미라는 관점에서 반드시 필요한 내용이 아니기에 which를 사용했다.

Fortran is perfect for mathematical calculations that don't involve linear algebra.

반면 이 경우 that 이하의 내용이 어느 경우에 Fortran을 사용하기에 좋은지를 구체적으로 설명하기 때문에, 종속절의 내용이 반드시 필요하다고 볼 수 있다. 따라서 that이 쓰였다.

한편, that과 which를 구분하는 tip이 있다. 소리내어 읽어봤을 때 종속절 앞에 잠시 끊어 읽는다 싶으면 which, 그렇지 않으면 that을 쓰라고 한다. 아무래도 보통 사람들은 의미가 다르면 잠시 멈추게 되고, 직결되는 내용이면 붙여 읽으려는 성향이 있나 보다.

추가로 주의할 점은, which 앞에는 콤마를 붙이되 that 앞에는 붙이지 말 것.

출처 : https://developers.google.com/tech-writing/one/short-sentences#exercise_3​