Hãy biết rõ cử tọa trước khi bắt đầu

Trước khi bạn tạo ra bất kỳ lời giải thích nào, bạn phải hiểu được bạn đang giải thích cho ai. mô tả tương tự về một hệ thống API sẽ nghe hoàn toàn khác khi nhắm vào một người giữ trái phiếu không công nghệ và một nhà phát triển trẻ so với một kiến trúc sư dày dạn kinh nghiệm. bắt đầu bằng cách hỏi: kiến thức cơ bản của họ là gì? họ đang cố gắng đạt được gì với thông tin này? những quan niệm sai lầm phổ biến nào họ có thể giữ?

Nếu cử tọa có ít kiến thức kỹ thuật, hãy tránh cho rằng mình quen thuộc với những từ cơ bản như “máy chủ hoặc“ bộ nhớ tạm, hoặc bộ phận nhận thức, cung cấp những định nghĩa nhanh chóng ngay cả cho những khái niệm có vẻ đơn giản.

Nếu không thích nghi được với cử tọa, bạn có thể điều chỉnh chiều sâu, tốc độ và từ vựng của lời giải thích ban đầu, và việc đầu tư này sẽ giảm bớt những câu hỏi sau đó và lưu ý nhiều hơn.

Dùng ngôn ngữ và lời giải thích đơn giản

Khi có thể, thay thế những từ ngữ chuyên ngành bằng những từ thông dụng, thay vì nói “một cách ngắn gọn, định nghĩa rõ ràng khi lần đầu tiên xuất hiện.

So sánh dữ liệu với nước chảy qua ống: ống là kênh, nước là dữ liệu, và van là một cái ga hay giới hạn tốc độ.

Một phương pháp hữu hiệu khác là dùng [FLT: 0] chuỗi [FLT: 0] ): bắt đầu với một so sánh đơn giản, rồi xây dựng trên nó khi giải thích được sự phát triển.

Chia thông tin ra thành phần nhỏ hơn

Hãy phân tích khái niệm thành những đoạn nhỏ, mỗi cấu trúc hợp lý trên mô-đun này tiếp cận các gương theo mô-đun này cách não xử lý tự nhiên thông tin mới: bộ nhớ ngắn hạn chỉ có thể chứa khoảng 4 đến 7 vật cùng một lúc. bằng cách trình bày thông tin theo những bước nhỏ, bạn tôn trọng giới hạn nhận thức đó.

Dùng các bước số hoặc điểm đạn để sắp xếp chuỗi.

  • Dữ liệu trông như thế nào mà không cần quét bảng chỉ mục ( đầy đủ).
  • Làm thế nào một chỉ mục tạo một cấu trúc nhỏ hơn (như chỉ mục của sách).
  • Cơ sở dữ liệu sử dụng chỉ số để tìm các hàng nhanh hơn.
  • Trao đổi: đọc nhanh hơn, viết chậm hơn, lưu trữ thêm.

Mỗi đoạn nên được tự giữ lại. Kết thúc mỗi đoạn với một tiểu cơ hoặc một câu chuyển tiếp dẫn đến đoạn tiếp theo. giá đỡ này giúp khán giả tạo nên một bức tranh hoàn chỉnh mà không cảm thấy bị mất hay bị quá tải.

Dùng các trợ giúp và sơ đồ

Hình ảnh có giá trị hàng ngàn từ — đặc biệt khi những từ này miêu tả những tiến trình kỹ thuật trừu tượng, có thể biến những mối quan hệ rối loạn thành những hình vẽ rõ ràng, trực giác.

Khi thiết kế hình ảnh, hãy theo nguyên tắc cơ bản của sự rõ ràng:

  • Có nhãn hiệu rõ ràng.
  • Dùng mũi tên để chỉ hướng dữ liệu hoặc kiểm soát dòng chảy.
  • Giới hạn mỗi biểu đồ thành một khái niệm chính.
  • Dùng mã màu nhất định cho các yếu tố liên quan.

Để có tài liệu kỹ thuật số, hãy xem xét việc sử dụng các công cụ như [FLT: 0] vẽ.io hoặc [FLT:] để tạo ra các biểu đồ chuyên nghiệp. Sơ đồ tương tác, nơi người dùng có thể nhấp vào để tiết lộ chi tiết, đặc biệt hữu hiệu trong các hướng dẫn trực tuyến. Ngay cả một sơ đồ đơn giản trước và sau đó — hiển thị một tiến trình không có tối ưu hóa và rồi với nó — có thể giúp cho một giải pháp kỹ thuật rõ ràng hơn.

Cung cấp ví dụ thực tế

Thay vì giải thích “sự kiện này trong một hình ảnh trừu tượng, hãy miêu tả cách thức thức nấu ăn trong nhà bếp: thường xuyên dùng thành phần trong tay, nhưng ít vật dụng thông dụng hơn thì ở trong kho tầng hầm. Tương tự, một bộ duyệt web có những bộ nhớ tạm, các hình ảnh và kịch bản để các cuộc thăm viếng lại nhanh hơn.

Khi thảo luận về các thuật toán, hãy dùng các kịch bản hằng ngày, giải thích “khi yêu cầu cử tọa sắp xếp một bộ bài, hãy dùng những con búp bê kiểu Nga cổ điển (marryoshka) hoặc dùng khái niệm giải quyết vấn đề bằng cách giải quyết một phiên bản nhỏ hơn của cùng vấn đề.

Một kỹ thuật khác là đi qua một [FLT: 0] ví dụ [FLT:]. Đối với một thủ tục kỹ thuật như cài đặt một đường ống dẫn DevOps, hiển thị các lệnh, kết quả chính xác, và kết quả ra từng bước. Các ví dụ làm việc giảm tải nhận thức và cho phép người mới xem tiến trình lý luận trước khi cố gắng thực hiện nó.

Khuyến khích người ta đặt câu hỏi và trả lời

Trong các trang web, hãy tạo khoảng trống cho cử tọa đặt câu hỏi, nhầm lẫn giọng nói hoặc những giả định.

Khi một người hỏi một câu hỏi, hãy tự nhắc lại để xác nhận bạn hiểu những gì họ đang thực sự hỏi. thường thì một lời giải thích kỹ thuật không được giải thích bởi vì người giải thích trả lời một câu hỏi khác với câu hỏi của người học. dùng câu hỏi như là công cụ chẩn đoán: họ tiết lộ phần nào của lời giải thích cần được trau dồi.

Đối với nhiều người hơn, những công cụ như [FLT: 0]Slido hoặc các cuộc thăm dò trực tiếp có thể đặt ra những câu hỏi vô danh.

Tóm tắt điểm then chốt và lấy ý tưởng cốt lõi

Tóm lại ngắn gọn giúp cử tọa củng cố những gì họ học và củng cố những điều quan trọng nhất.

Chẳng hạn, sau khi giải thích về việc nạp lượng, bạn có thể tóm tắt: “Một người cân bằng tải như một cảnh sát giao thông cho các yêu cầu web, phân phối giao thông qua nhiều máy chủ để ngăn chặn bất cứ máy chủ nào bị quá tải, giúp ứng dụng của bạn nhanh và đáng tin cậy.

Cũng hãy xem xét một “bản tóm tắt một trang web hoặc một sơ đồ đơn giản để ghi lại toàn bộ khái niệm trong một cái nhìn.

Name

Kể một câu chuyện

Con người được liên kết để kể chuyện. Hãy kể câu chuyện về một ứng dụng chậm đã được thêm vào chỉ số, và kết quả cuối cùng là sự thất vọng có thể làm cho chi tiết kỹ thuật trở nên rõ ràng.

Dùng nhiều dạng thức đại diện

Những người khác nhau học theo những cách khác nhau. kết hợp văn bản, sơ đồ, từ ngữ, bài tập tay, và mã để tiếp cận với nhiều khán giả hơn. đối với những chủ đề phức tạp, một chương trình biểu diễn ngắn có thể hiệu quả hơn nhiều so với các trang văn bản. ngay cả trong một tài liệu riêng lẻ, bao gồm một khối mã bên cạnh một sơ đồ kiến trúc và địa chỉ tương tự tương tự nhiều kiểu học cùng một lúc.

Hãy lặp lại và thử nghiệm sự giải thích của bạn

Sau khi giải thích, hãy tự hỏi: “Các cử tọa có hiểu không?

Hãy cố gắng “xem lại lời giải thích của bạn với một đồng nghiệp không phải là chuyên gia về lĩnh vực này, nếu họ có thể diễn giải chính xác ý tưởng cốt lõi, bạn sẽ giải thích rõ ràng.

Kết luận

Rõ ràng và ngắn gọn giải thích các khái niệm kỹ thuật phức tạp là một kỹ năng có thể học và tinh tế. bạn có thể cải thiện đáng kể hiệu quả giao tiếp của mình.

Để đọc sâu hơn, hãy xem xét lời khuyên của Nelsen Norman Group on prochild wLT:1) ) hoặc ) sách mỏng Kinh doanh (FLT:2) về việc giải thích những ý tưởng phức tạp . Hãy nhớ rằng mỗi lời giải thích là cơ hội để xây dựng lòng tin và hiểu — hai yếu tố quan trọng để thành công trong việc hợp tác kỹ thuật.