Table of Contents
당신이 시작하기 전에 당신의 Audience를 알고
기술하기 전에, 당신은 먼저 설명하는 것을 이해해야합니다. REST API의 동일한 설명은 비 기술 이해 관계자가 계절 건축가를 versus 중반 개발자를 대상으로 한 경우 완전히 다른 소리가됩니다. 요청으로 시작하십시오. 기본 지식은 무엇입니까? 이 정보를 달성하려고하는 것은 무엇입니까? 일반적인 잘못이 이미 보유 할 수 있습니까?
여러분의 청중이 조금 기술적인 배경이 있다면, “서버” 또는 “cache”와 같은 기본 용어로 익숙함을 피하십시오. 겉으로 간단한 개념을 위해도 빠른 정의를 제공합니다. 복잡한 경우, 기초 세부 정보를 건너뛰는 경험이 풍부한 실무자에 대해 설명 효율을 유지합니다. 유용한 기술은 청중의 정신 “knowledge map”을 만들 것입니다. 따라서, 귀하의 언어에 따라 맞춤화됩니다.
청중에 적응할 실패는 기술 통신에서 가장 일반적인 pitfalls 중 하나입니다. 청취인의 또는 독자의 시작 지점을 진단함으로써, 당신은 당신의 설명의 깊이, 속도 및 구급차를 조정할 수 있습니다. 이 초기 투자는 몇 가지 후속 질문과 더 나은 유지로 지불합니다.
Simple Language 및 Analogies를 사용하여
Jargon과 약어는 신속하게 청중을 외계인 할 수 있습니다. 가능한 한, 일상 단어와 전문 용어를 대체 할 수 있습니다. 예를 들어, "동기적인 이벤트 구동 아키텍처"라고 말하면 "작업이 독립적으로 전송하고 신호를 전송하는 시스템"이라고 말할 수 있습니다. 기술 용어를 사용해야하는 경우, 처음 나타나는 것을 명확하게 정의하십시오.
아날로그는 무해한과 친숙한 사이 간격을 밝기를 위한 가장 강력한 공구의 한개입니다. 관을 통해서 흐르는 물에 자료 스트리밍을 비교하십시오: 관은 수로, 물입니다 자료이고, 벨브는 기관지 또는 비율 제한기입니다. 그런 아날로그는 끈으로 잡는 생생한 정신 이미지를 창조합니다. 그러나, 몇몇 점에서 이탈하는 아날로그를 뻗기 위하여 주의하지 마십시오 — 각 대사는 끊습니다. 항상 새로운 오해를 소개하는 것을 피하기 위하여 한계를 주의하십시오.
또 다른 효과적인 방법은 metaphor chains: 간단한 비교를 시작, 그 때 설명이 성장함에 따라 구축. 예를 들어, 클라우드 컴퓨팅 설명은 "클라우드는 전력 그리드처럼 시작 될 수 있습니다,"그 후 가상 서버로 "하늘속에 존재,"그리고 마지막으로 "오선 엘리베이터 시스템의 직접 트래픽"으로 균형을 논의.
더 작은 부품으로 정보를 끊기
복잡한 아이디어는 1개의 gulp에서 거의 이해됩니다. 소화 펑크로 개념을 분해하고, 이전에 각 건물로 통용됩니다. 이 모듈 접근법은 우리의 두뇌가 자연적으로 새로운 정보를 처리하는 방법을 반영합니다: 단기 기억은 한 번에 4개에서 7개의 품목에 관하여 붙들 수 있습니다. 작은 단계에 있는 정보를 선물해서, 당신은 인식 한계를 존중합니다.
수를 놓은 단계 또는 총알 점수를 사용하여 순서 구성. 예를 들어, 데이터베이스 인덱스가 작동하는 방법을 설명 할 때, 당신은 그것을 깰 수 있습니다:
- 인덱스 없이 어떤 데이터가 나타날 수 있습니다. (전체 테이블 스캔).
- 인덱스는 작은 검색 구조를 만드는 방법 (서의 인덱스와 같은).
- 데이터베이스는 인덱스를 사용하여 줄을 더 빨리 찾습니다.
- 거래 오프 : 빠른 읽기, 느린 쓰기, 추가 저장.
각 펑크는 자기 유지해야합니다. 다음 조각으로 이어지는 미니 - 연구원 또는 전환 문장을 가진 각 세그먼트를 종료하십시오. 이 비계는 청중이 손실되거나 압도적 인 느낌없이 완벽한 그림을 구축하는 데 도움이됩니다.
Visual Aids 및 Diagrams 사용
그림은 수천 단어가 가치가 있습니다. 특히 그 단어가 추상 기술 프로세스를 설명 할 때. 시각적 표현은 명확한 직관적 인 레이아웃으로 엉킴 관계를 변환 할 수 있습니다. 다이어그램, 유량계, 시스템 아키텍처 도면 및 화이트 보드 도움 학습자는 아이디어의 구조를 볼 수 있습니다.
시각을 지정할 때, 선명한 기본 원칙을 따르십시오:
- 라벨 구성 요소는 명확하게.
- 데이터 또는 제어 흐름의 방향을 나타내는 화살표를 사용합니다.
- 각 다이어그램을 하나의 주요 개념으로 제한하십시오.
- 관련 요소에 대한 일관된 색상 코딩을 사용합니다.
디지털 문서의 경우 draw.io] 또는 Lucidchart]과 같은 도구를 사용하여 전문 다이어그램을 생산합니다. 대화 형 다이어그램은 사용자가 더 자세히 알 수 있는 경우, 특히 온라인 튜토리얼에서 효과적입니다. 최적화 없이 프로세스를 보여주는 간단한 전후 다이어그램도, 그 결과 기술 솔루션의 이점을 명확하게 만들 수 있습니다.
Real-World 예제 제공
앨리슨의 웹 브라우저는 웹 브라우저에서 쿠키를 사용합니다. 이 쿠키는 웹 브라우저에서 쿠키를 사용합니다. 이 쿠키는 웹 브라우저에서 쿠키를 사용합니다. 이 쿠키는 웹 브라우저에서 쿠키를 사용합니다. 이 쿠키는 웹 브라우저에서 쿠키를 사용하는 데 사용됩니다.
알고리즘에 대해 논의 할 때 일상 시나리오를 사용합니다. 관객을 요청하여 카드의 갑판을 정리하는 것을 상상하십시오. "재큐먼트"는 고전적인 러시아 배열 인형 (matryoshka)을 통해 소개되거나 같은 문제의 작은 버전을 해결함으로써 문제를 해결하는 개념을 통해 설명 할 수 있습니다. 이러한 구체적인 참조 포인트는 기존의 정신 모델에 대한 새로운 지식을 앵커합니다.
또 다른 강력한 기술은 ]를 통해 걸을 것입니다. 예를 들어]. DevOps 파이프라인을 설치하고 같은 기술적인 절차를 위해 정확한 명령, 출력 및 결과 단계에 의해 단계. 작업 예는인지 부하를 감소시키고 그 자체 시도하기 전에 소원 과정을 관찰 할 수 없습니다.
질문 및 의견
기술 설명은 한 가지 방향 방송이 결코 안됩니다. 질문을 할 수있는 잠재 고객을 위해 공간을 만들거나, 목소리 혼란, 또는 문제 가정. 라이브 설정에서 자주 일시 중지하고 질문을 초대합니다. 작성된 문서에서 "공동 질문"섹션 또는 피드백 양식을 포함합니다.
Active listening은 똑같이 중요합니다. 누군가가 질문을 할 때, 자신의 단어에서 나머지는 정말 묻은 것을 이해하기 위해 이해해야합니다. 종종 기술 설명은 학습자가 한 것보다 다른 질문에 대답하기 때문에 실패합니다. 진단 도구로 질문을 사용하여 설명이 필요한 정제 부분을 나타냅니다.
더 큰 청중을 위해, 도구는 같은 Slido 또는 라이브 설문 조사는 익명 질문을 표면 할 수 있습니다. 문서에서, 추가 “이 도움이?” 각 섹션의 끝에서 위젯은 당신이 comprehension에 직접 피드백을 제공합니다. 효과적인 의사 소통이 결정적 인 기억 - 피드백 루프는 당신이 실시간으로 접근을 조정할 수 있도록 도와줍니다.
핵심의 생각을 요약하고 핵심의 생각을 다시
모든 설명의 끝에, 에센셜로 다시 원. 짧은 요약은 그들이 배운 것을 통합하고 가장 중요한 도처를 강화하는 데 도움이. 명확한 사용, 기억에 남는 나머지 주요 아이디어의 - 누군가가 반복 할 수있는 일반 언어에서 선호.
예를 들어, 로드 밸런싱을 설명한 후, 당신은 요약 할 수 있습니다: "로드밸런서는 웹 요청에 대한 트래픽 복사와 같습니다. 그것은 여러 서버에서 들어오는 트래픽을 배포하여 응용 프로그램을 빠르고 신뢰할 수있는 압도적으로 유지하면서 단일 서버를 방지합니다." 이 일체의 재캡은 그것을 전진하는 상세한 설명보다 훨씬 쉽게 호출 할 수 있습니다.
또한 "원 페이지" 속임수 시트 또는 한 눈에 전체 개념을 캡처 간단한 다이어그램을 제공 고려하십시오. 요약은 새로운 정보를 소개하지 않아야합니다. 그들은 이미 휴대용, 기억에 남는 형식으로 덮여 증류해야합니다.
심도에 대한 추가 전략
글쓰기
인간은 narrative를 위해 타전됩니다. 간단한 이야기에 대한 설명의 포장 - 문제, 솔루션으로 여행, 그리고 최종 결과 - 기술적인 세부 사항 스틱을 만들 수 있습니다. 예를 들어, 데이터베이스 인덱스 전략의 기능을 나열하는 대신 팀이 인덱스를 추가 한 후 스냅 된 느린 응용 프로그램의 이야기를 알려줍니다. 구호의 감정적인 아크는 기술적인 세부 사항을 앵커하는 데 도움이됩니다.
다중 대표 형식 사용
다른 사람들은 다른 방식으로 학습합니다. 텍스트, 다이어그램, 말, 손에 운동 및 코드 스니펫을 결합하여 광경을 도달합니다. 복잡한 주제를 위해 짧은 비디오 데모는 번개 페이지보다 훨씬 효과적 일 수 있습니다. 건축 다이어그램과 텍스트 아날로그 주소 여러 학습 스타일과 함께 코드 블록을 포함한 단일 문서 내에서도 가능합니다.
당신의 영어 회화
이 웹 사이트는 귀하가 웹 사이트를 탐색하는 동안 귀하의 경험을 향상시키기 위해 쿠키를 사용합니다. 이 쿠키들 중에서 필요에 따라 분류 된 쿠키는 웹 사이트의 기본적인 기능을 수행하는 데 필수적이므로 브라우저에 저장됩니다. 또한이 웹 사이트의 사용 방식을 분석하고 이해하는 데 도움이되는 제 3 자 쿠키를 사용합니다. 이 쿠키는 귀하의 동의하에 만 브라우저에 저장됩니다. 이러한 쿠키를 거부 할 수도 있습니다. 이러한 쿠키 중 일부를 선택 해제하면 검색 환경에 영향을 미칠 수 있습니다.
"peer review"를 시도하십시오. colleague와 설명은 분야에서 전문가가 아닙니다. 그들이 정확하게 핵심 아이디어를 기화 할 수 있다면, 당신의 설명은 단단합니다. 투쟁한다면, 혼란을 일으키는 섹션을 핀 포인트하고 재작업하십시오.
관련 기사
엄밀하고 간결하게 복잡한 기술 개념을 설명하는 것은 배운 기술과 세련될 수 있는 기술입니다. 엄밀한 언어와 아날로그를 사용하여 청중을 사용하여, 정보를 끊고, 시각을 고용하고, 실제 사례를 제공해서, 상호 작용을 격려하고, 핵심 점을 요약해서, 당신은 극적으로 당신의 커뮤니케이션 효율성을 개량할 수 있습니다.
더 깊은 독서를 위해, ]Nielsen Norman Group의 기술 쓰기 또는 ]Harvard Business Review의 복잡한 아이디어 설명에 대한 조언. 모든 설명은 신뢰와 이해를 구축 할 수있는 기회 기억 — 성공적인 기술 협력을위한 두 가지 중요한 재료.