과학 글쓰기 잘하기

과학 글쓰기 잘하기은(는) 무엇을 하나요?

이 스킬은 글쓰기에 관한 네 권의 책을 요약합니다: Strunk, 문체의 요소 (1918/1920); Zinsser, 글쓰기 잘하기 (2001년 판); Alley, 과학적 글쓰기 기술 (제4판, 2018); 그리고 Heard, 과학자를 위한 글쓰기 안내서 (2016). 참조 파일에 있는 모든 규칙은 이 중 한 권에서 가져온 것이며, 저자가 명시되어 있어 사용자가 가치를 평가할 수 있고 독자가 확인할 수 있습니다. 이 책들은 독자가 결코 알아차리지 못할 정도로 명확한 산문이라는 공통된 목표에 동의합니다. Heard는 이것을 텔레파시라고 부릅니다. Alley의 법칙은 아인슈타인의 법칙입니다: 가능한 한 간단하게, 그러나 더 간단하게는 말고. Zinsser의 방법은 빼기입니다. Strunk의 방법은 "불필요한 단어를 생략하라"입니다.

모든 규칙이 기반하는 네 가지 원칙

1. 독자의 노력이 유일한 척도이다. 독자가 길을 잃었다면, 작가가 충분히 주의하지 않은 것입니다 (Zinsser). 어떤 선택이 독자가 이야기를 더 쉽게 이해할 수 있게 하는지 물어봄으로써 모든 장인 정신 문제를 해결하십시오 (Heard). 단어를 선택하기 전에 누가 읽는지, 왜 읽는지, 그리고 그들이 이미 무엇을 알고 있는지 분석하십시오 (Alley).
2. 의미하는 바를 말하고, 의도하지 않은 것은 말하지 마라. 정밀성과 명확성은 서로 상충됩니다; 불필요한 복잡성은 과학적 산문에서 가장 흔한 실패입니다 (Alley). 증거에 정확하게 맞춰 조심스럽게 말하고, 어떤 것도 부풀리지 마십시오 (Heard, Alley).
3. 모든 단어는 그 자리를 정당화해야 한다. 문장에는 불필요한 단어가, 문단에는 불필요한 문장이 없어야 합니다 (Strunk). 대부분의 초고는 정보 손실 없이 단어의 절반을 잃을 수 있습니다 (Zinsser). 모든 문자를 스스로를 정당화하도록 강제하십시오 (Heard).
4. 사실과 추론, 한 줄로. 과학적 글쓰기는 연속된 문장들로 이루어져 있으며, 그 "연속"이 어려운 점입니다 (Zinsser). 문장당 하나의 아이디어, 행위자 다음에 행동, 새로운 정보는 끝에 (Alley, Heard, Strunk).

규칙 뒤에 있는 이유가 규칙 자체보다 중요합니다. 규칙과 독자의 관심이 충돌할 때, 독자가 이깁니다. 참조 파일은 각 규칙이 존재하는 이유를 설명하므로 예외 상황을 판단할 수 있습니다.

매번 여기서 시작하세요

1. 모드를 지정하세요. 초안 작성 (새 텍스트 생성), 수정 (제공된 텍스트 다시 쓰기), 진단 (문제점 순위 매기기, 다시 쓰지 않음), 또는 계획 (초안 작성 전 문서 설계). 요청이 암시하는 것을 선택하십시오; 명확하지 않은 경우에만 어떤 것을 선택했는지 말하십시오.
2. 독자, 목적, 상황을 고정하세요 (Alley). 누가 이것을 읽는지, 왜, 그들이 무엇을 알고 있는지, 그리고 매체가 길이와 형식에서 무엇을 허용하는지. 저널 페이지 제한은 주장에 한 문장의 정당성을 부여합니다; 보고서나 장은 문단을 허용합니다.
3. 필요한 것만 로드하세요. references/house-style.md를 매번 먼저 로드하세요 (짧습니다): 저자의 고유 선호도를 담고 있으며, 저자가 편집할 수 있는 시작 세트를 제공합니다. 그런 다음 모드에 필요한 파일들을 아래 참조 맵의 읽기 목록에서 로드하세요. 파일은 목차를 포함합니다; 작업이 관련된 섹션만 읽고, 모든 파일을 처음부터 끝까지 읽지 마십시오.
4. 신호 스크립트를 최대 두 번 실행하세요: 문단보다 긴 텍스트를 제공받은 경우, 자세히 읽기 전에 한 번, 그리고 최종 텍스트를 전달하기 전에 한 번 실행하세요: python3 scripts/prose_signals.py <file> (또는 --json). 이 스크립트는 문장 길이, 수동태 후보, 허사 도입구, 명사화, 군더더기 표현, 완곡어, 강조어, 문장 시작의 꾸밈없는 "this", 명사 문자열, 줄표, 한 번만 사용된 약어를 보고합니다. 헤더는 이것이 무엇인지 말해줍니다: 신호일 뿐, 판결이 아닙니다. 이를 사용하여 어디를 먼저 볼지 결정한 다음 읽으십시오.
5. 변경되어서는 안 되는 것을 결정하세요. 숫자, 주장, 인용, 정의된 용어, 그리고 텍스트가 저자 자신의 것일 때 하우스 스타일 파일이 보호하는 논증의 전환점과 어조는 변경하지 마십시오. 출처가 담고 있지 않은 숫자, 인용, 결과 또는 주장을 절대 만들어 내지 마십시오. 누락된 부분은 ???로 표시하고 목록화하십시오.

모드: 초안 작성

메모, 개요 또는 결과로부터 초안 작성.

1. 먼저 이야기를 찾으세요. 두 문장짜리 미니 요약문을 작성하십시오: 중심 질문과 그 답 (Heard). 이것이 무엇이 속하는지를 결정합니다: 이것을 포함하는 것이 이야기를 전달하는 데 도움이 될까요, 아니면 방해가 될까요? 책 섹션의 경우, 해당 섹션이 답하고 장이 아직 답하지 않은 독자의 질문을 명시하십시오 (하우스 스타일). 메모가 답을 가지고 있지 않다면, 이야기는 질문과 설계로 구성되며, 그렇게 말하십시오.
2. references/structure.md에서 뼈대를 가져오세요. 서론은 영역에서 간극으로, 그리고 이 작업이 하는 일로 이동하며, 질문, 접근 방식 및 주요 결과로 끝납니다 (Heard); 시작 부분의 폭은 매체에 의해 결정됩니다. 초록은 결과를 알려주는 정보 요약입니다 (Alley, Heard). 토론은 첫 번째 문단에서 질문에 답하고 가장 중요한 발견과 그 중요성으로 끝납니다 (Heard). 장은 방향을 제시하는 문장으로 시작하고 섹션을 매핑합니다 (Alley, 하우스 스타일).
3. 글을 쓰기 전에 일관성을 결정하세요 (Zinsser): 인칭 대명사, 시제, 어조. 끝까지 유지하십시오.
4. 빠르게 초안을 작성한 다음 순서대로 수정하세요. 완전한 초안으로 시작하고, 누락된 것은 자리 표시자를 사용하십시오 (Heard). 그런 다음 아래 수정 단계를 자신의 초안에 적용한 후 전달하십시오. 독자는 수정된 초안만 봅니다.
5. 출처가 지지하는 내용만 쓰고, 붙여넣기 가능한 텍스트에 누락된 부분을 남기지 마십시오. 메모가 담고 있지 않은 주장, 메커니즘 또는 결과를, 논증을 연결하기 위해서라도 추가하지 마십시오 ("식물을 심는 것은 이웃을 시원하게 할 수 있지만 소득을 높일 수는 없다"는 주장이지 전환이 아닙니다). 메모 자체의 사실로 연결하거나, 이음새를 남겨두고 메모에 누락된 부분을 표시하십시오; 추가된 주장을 공개한다고 해서 그것이 허용되는 것은 아닙니다. 메모에 주요 결과가 없을 때는, 서론을 질문과 접근 방식 (Heard가 대안으로 명명한 순서)으로 끝내고, 자리 표시자로 끝내지 마십시오; 메모는 마무리 결과 문장이 추가할 것을 말해줍니다. 우선권 주장 ("최초로 테스트한")은 한정어 ("우리가 아는 한")를 유지합니다. 왜냐하면 문헌 검색은 분석이 해결할 수 없는 것이기 때문입니다 (하우스 스타일: 진정으로 미해결된 것은 완곡하게 표현하십시오).
6. 요청된 형식으로 텍스트를 전달하십시오 (원고 산문의 경우 붙여넣기 가능; 출력 형식 참조)와 함께 누락된 부분, 가정, 그리고 저자가 되돌리고 싶어할 만한 한두 가지 선택에 대한 짧은 메모를 추가하십시오 (예: "초안은 설계로 끝납니다; 주요 결과로 끝내려면, 한 문장을 추가하세요: …").

모드: 수정

사용자가 제공한 텍스트를 다듬거나 명확하게 합니다. 공동 저자의 "읽기 나쁘다"는 요청이 이 모드에 해당합니다.

1. 전체 구절을 한 번 읽어 이야기와 저자의 의도를 파악하십시오 단어 하나도 건드리기 전에. "여기서 시작"의 협상 불가 사항을 기록하십시오.
2. 요청에 따라 편집 규모를 선택하고, 어떤 것을 선택했는지 말하십시오. 세 가지 경우:
   • 특정 구절을 고치거나 저자가 완성한 장을 수정하라는 요청: 정확한 구절이나 문장을 수정하고, 다른 곳의 사실적 또는 과학적 오류만 보고하십시오 (하우스 스타일).
   • 구절을 강화하거나, 개선하거나, 잘 읽히도록 만들라는 요청 (저자 자신의 텍스트 포함): 다음 세 가지를 모두 수행하고 각각을 보고하십시오. 첫째, 가치 테스트: 주장을 담고 있지 않은 문장 (자기 선언, 예: "이 장은 이유를 설명합니다…", 요약, 주장을 바꾸지 않는 주의 사항, 초록 내 장 지도)을 식별하고 삭제를 되돌릴 수 있는 항목으로 제안하되, 문장을 인용하고 이유를 제시하십시오; 그러한 문장을 유지한다면, 이유를 말하십시오. 둘째, 가장 도움이 될 구조적 이동 (결과가 뒤따르는 곳으로 이동된 문장, 묻힌 발견을 앞으로 가져오기, 네 개의 평행 문장을 하나로 접기), 같은 방식으로 제안하십시오. 셋째, 구문 수리: 모호한 연결어 ("때문에" 대신 "이후로" 사용), 명확한 지시 대상이 없는 대명사 또는 "그것들", 비유적 동사, 인접한 문장에 있는 중복된 구문. "모든 주장과 용어를 정확히 유지하라"는 새로운 주장과 이름이 변경된 용어를 금지합니다; 이러한 수리(주장을 변경하지 않음)를 금지하지 않습니다. 스타일만을 위해 전체 문단을 절대 다시 쓰지 말고, 저자의 어조, 용어 및 주장을 유지하십시오.
   • 초안을 다듬으라는 요청: 다시 쓰기는 허용되지만, 모든 사실, 숫자, 용어 및 인용은 변경 없이 유지됩니다. 이 스킬의 실제 리뷰는 중간 경우를 명확히 했습니다: "강력한" 초록을 요청했을 때, 저자는 세 개의 구문을 바꾸고 구조를 그대로 둔 수정보다 문장을 이동시킨 수정을 선호했습니다.
3. 단일 목적의 라운드로, 이 순서대로 수정하십시오 (Heard, Alley). 잘라낼 것을 다듬어서는 안 되기 때문입니다:
   • 내용: 구절의 임무에 기여하지 않는 것을 자르십시오; 주장이 증거와 일치하는지 확인하십시오; 증거가 필요한 완곡어만 유지하십시오.
   • 구조와 문단: 문단당 하나의 요점, 초반에 제시; 각 문장은 이전 문장과 연결되는 방식으로 시작; 새롭고 중요한 항목은 문장과 문단의 끝에 위치 (references/paragraphs.md).
   • 문장: 행위자 다음에 행동, 동사는 초반에, 문장당 하나의 아이디어, 수동태가 세 가지 임무 중 하나를 수행하지 않는 한 능동태, 꾸밈없는 "this" 없음, 분사구문 오류 없음, 모호한 대명사 없음 (references/sentences.md).
   • 단어: 군더더기 표현, 명사화, 강조어, 중복된 완곡어, 독자가 모르는 전문 용어, 불필요한 정밀도로 보고된 숫자 (references/words.md). 구절에 한 번만 사용된 약어는 메모와 함께 그대로 두지 말고 텍스트 자체에 풀어서 쓰십시오; 문서의 뒷부분에서 다시 나타난다면 메모에 그렇게 말하고 정의를 유지하십시오.
   • 기계적 사항: 도입구 뒤의 쉼표, 옥스포드 쉼표, 줄표 없음, 섹션 내에서 시제 일관성, 약어는 한 번 정의.
4. 독자를 시뮬레이션하십시오 (Heard). 오직 단어만 있는 낯선 사람으로서 수정본을 읽으십시오. 문장 간의 연결을 위해 머릿속으로 소리 내어 읽으십시오 (Zinsser).
5. 아무것도 변경되지 않았는지 확인하십시오. 모든 숫자, 단위, 간격, 인용 및 정의된 용어는 출처와 동일합니다. 주장은 사용자가 변경을 요청하지 않는 한 출처가 만든 것보다 강하지도 약하지도 않습니다.
6. 붙여넣기 가능한 텍스트, 변경 목록, 그리고 문장을 잘라낸 경우 잘라낸 목록을 전달하십시오 (출력 형식 참조).

모드: 진단

재작성 없이 순위가 매겨진 소견. 또한 "이것이 왜 틀렸습니까?"와 "여기서 수동태를 사용해야 합니까?"에 대한 모드이기도 합니다: 규칙, 저자, 이유, 그리고 참조 파일에서 하나의 전후 예시를 제시하십시오.

1. 스크립트를 실행하십시오; 의도된 독자로서 읽으십시오; 전체 문서의 이야기를 염두에 두십시오.
2. 독자에게 드는 비용에 따라 소견의 순위를 매기십시오, 실질을 기계적 사항보다 먼저: 이야기와 주장 (과장된 주장, 누락된 경계, 해석을 뒷받침하지 않는 증거, 묻힌 주요 발견)이 첫 번째; 구조 (순서, 권력 위치, 누락된 연결, 결말이 있어야 할 곳의 요약)가 두 번째; 문단이 세 번째; 문장이 네 번째; 단어가 다섯 번째; 기계적 사항이 마지막.
3. 각 소견을 한 가지 형태로 작성하십시오: 문제가 되는 단어를 인용하고 (5~12개), 독자에게 무엇이 잘못되었는지 말하고, 원칙과 그 저자를 명명하고, 수정이 무엇을 할 것인지 말하십시오. 반복되는 기계적 오류는 개수와 함께 하나의 소견으로 그룹화하십시오.
4. 전체 진단은 섹션당 약 800~1,200단어로 유지하고, 최대 12개의 소견으로 유지하십시오. 실질을 담은 3~5개의 소견은 각각 한 문단씩 할애하고; 나머지는 개수와 하나의 인용된 예시와 함께 한 줄로 처리하십시오. 2,000단어의 소견을 읽어야 하는 독자는 그 어떤 것도 실행에 옮기지 않을 것입니다. 실질적인 발견을 희생하지 말고 기계적 소견에서 길이를 줄이십시오: 측정된 것과 주장된 것 사이에서 의미가 표류하는 용어 (근접성이 측정되었는데 "대기 오염"이 주장됨), 두 가지 강도로 만들어진 주장, 묻힌 발견. 섹션에서 한 번도 정의되지 않은 약어는 항상 한 줄 소견입니다.
5. 요청하지 않는 한 다시 쓰지 마십시오. 원칙이 예시 없이 명확하지 않다면, 수정된 문장 하나를 보여주고 예시임을 표시하십시오.
6. 가장 중요할 두세 가지 변경 사항을 순서대로 제시하며 마무리하십시오.

모드: 계획

초안 작성 전에 논문, 제안서, 장 또는 섹션을 설계합니다.

1. 독자, 목적, 상황, 매체 및 길이 예산 (Alley).
2. 두 문장짜리 미니 요약문, 그리고 판매 문구: 왜 이 질문이 저자가 아닌 이 독자에게 중요한지 (Heard). 소심한 프레이밍을 거부하십시오 ("보고된 연구가 없다").
3. 먼저 그림과 표를 섞으십시오; 그들이 제공하는 답변에 질문이 암시되도록 하십시오 (Heard). 논문에서 약 5개의 그림과 4개의 표를 초과하지 않도록 주의하십시오.
4. references/structure.md에서 문서 유형에 대한 뼈대, 그런 다음 주제 문장 개요: 각 문단의 요점을 순서대로 한 줄씩, 각 섹션의 임무를 명명.
5. 권력 위치를 표시하십시오: 각 섹션의 첫 번째와 마지막 문단, 각 문단의 첫 번째와 마지막 문장, 제목, 표제 (Alley, Heard). 주요 결과를 텍스트가 흰 공백과 만나는 곳에 배치하십시오.
6. 제외할 사항을 목록화하십시오 (Heard의 세 가지 테스트: 본문, 보충 자료, 또는 미발행)과 아직 채워야 할 자리 표시자.

출력 형식

• 원고 산문은 붙여넣기 가능합니다: 일반 텍스트, 문단당 하나의 물리적 줄, 마크다운 표식 없음, 글머리 기호 없음, 번호 매기기 없음, 코드 펜스 없음, 하드 줄 바꿈 없음, 줄표 없음. 저자는 Word에 붙여넣습니다. 텍스트가 기존 산문을 대체하는 경우, 착륙 지점을 명명하십시오: 제거할 첫 번째와 마지막 단어를 인용하고 대체가 문장, 문단 또는 하위 섹션인지 말하십시오 (하우스 스타일).
• 변경 목록은 짧고 그룹화됩니다: 무엇이 변경되었는지, 규칙과 그 저자, 왜 독자에게 도움이 되는지. 사소한 사항 (쉼표, 오타)은 개수와 함께 한 줄로 처리합니다.
• 잘라낸 목록은 각 삭제된 문장과 그 이유 (반복, 메타 담화, 주장을 변경하지 않는 주의 사항, 독자의 해석을 바꿀 수 없는 세부 사항)를 명명합니다.
• 소견 (진단)은 일반 채팅 형식을 사용하며 순위가 매겨집니다.
• .docx 입력: 텍스트를 추출하고, 작업한 후 붙여넣기 가능한 산문을 전달하십시오. 파일 자체의 변경 추적은 docx 편집 라이브러리가 필요하지만…

[번역을 위해 잘림]