การอธิบายสิ่งต่างๆทางเทคนิคให้กับบุคคลที่ไม่ใช่ด้านเทคนิค [ปิด]

ฉันมักจะมีการอธิบายสิ่งที่ทางด้านเทคนิคและการตัดสินใจทางเทคนิคของฉันมากผู้จัดการฝ่ายเทคนิคและไม่ใช่ฉันรักอันยิ่งใหญ่ที่มัน อะไรเป็นวิธีที่ดีที่จะทำให้สิ่งที่สำคัญเป็นใบ้สำหรับส่วนที่เหลือของโลกที่ไม่มีความหลงใหลในการเขียนโปรแกรม?

ตัวอย่างคำถามที่ฉันถูกถาม:

• ทำไมคุณถึงใช้ Django แทน Java (ไม่ยอมรับว่ามันราคาถูกกว่า)
• ขอให้ฉันใช้ถ้อยคำใหม่โดยใช้คำศัพท์ที่ไม่ใช้ประโยคของฉันคือ "ไม่อนุญาตให้ใช้แท็ก HTML บางตัว" ฉันจะใบ้มันลงได้ยังไง?
• สิ่งอื่น ๆ ที่ทำให้รู้สึกดีกับผม แต่เป็นเพียงเพื่อให้พื้นฐานผมไม่ทราบวิธีการที่จะอธิบายได้
• ทำไมนี่ทำไมทำไมทุกอย่าง!

นอกจากนี้ฉันจะบอกผู้จัดการของฉันให้มองสิ่งพื้นฐานบน Google เช่น "เสาภาพคืออะไร"

ฉันมักจะใช้การเปรียบเทียบ นำสิ่งที่หัวข้อคือและคิดว่าสิ่งที่ไม่ใช่ด้านเทคนิคอย่างสมบูรณ์ที่พวกเขาจะเข้าใจและอธิบายให้พวกเขาด้วยวิธีการที่

ตัวอย่างที่ดีที่สุดที่ฉันนึกได้คือถ้าฉันต้องอธิบายการวางแนวของวัตถุฉันจะอธิบายมันโดยใช้การ์ด หรือเมื่อฉันพยายามอธิบายแนวคิดของอินเทอร์เน็ตไร้สายกับป้าผู้ยิ่งใหญ่ของฉัน (ที่ไม่เคยใช้คอมพิวเตอร์) ฉันใช้โทรศัพท์ไร้สายเพื่ออธิบาย

ฉันยังไม่ได้พบกับหัวข้อใด ๆ ที่ฉันไม่สามารถเป็นแบบนี้ได้

สิ่งที่ฉันใช้

^{เพื่อผลที่ดีและไม่ดีมาก}

• การเปรียบเทียบ:เมื่ออธิบายสถานการณ์หรือกระบวนการมันใช้งานได้ดีจริง ๆ ถ้าคุณสามารถอธิบายให้เข้าใจได้
• คำศัพท์ทั่วไป:แทนที่จะพูดถึงแท็ก HTMLคุณสามารถพูดรหัสได้ หากพวกเขาติดตามขอคำอธิบายอาจถึงเวลาสำหรับการสรุปย่อของ HTML และวิธีการทำงาน "หน้าเว็บถูกสร้างขึ้นจากบล็อกที่เรียกว่า" แท็ก "หากเบราว์เซอร์ของคุณไม่รองรับแท็กเฉพาะแท็กนั้นจะไม่แสดงอย่างถูกต้อง"
• สรุปและภาพรวม:บางครั้งมันทำงานได้ดีในการให้บทสรุปสั้น ๆ ก่อนที่จะกระทบหัวกับศัพท์แสงทางเทคนิค
• ลบศัพท์แสง: Turn "ฐานข้อมูลไม่สมดุลเมื่อโหลดโดยการร้องขอหลายรายการจากเครือข่ายย่อย IP" เป็น"ฐานข้อมูลกำลังมีปัญหาในการจัดการคำขอจากบางคน" หากคุณอาจต้องอธิบายให้แทนที่ด้วยอย่างอื่น หากคุณต้องอธิบายฐานข้อมูลคุณกำลังมีปัญหา "สถานที่จัดเก็บสิ่งของ" คือทางเลือกของฉัน
• ทัศนศิลป์:กระดานไวท์บอร์ดร็อค ใช้พวกเขาเพื่อประโยชน์ของคุณ
• ทำให้เป็นเรื่องเทคนิค: ช่วยให้ผู้จัดการผู้บังคับบัญชาและผู้ร่วมงานในวงช่วยได้ หากผู้จัดการบัญชีสับสนในการประชุมเพราะทุกคน แต่พวกเขาเข้าใจสิ่งที่ถูกกล่าวถึงมันอาจทำให้พวกเขาต้องการอ่านอีเมลเหล่านั้นที่พวกเขาใช้ CC ใช้เวลาในการเขียนบันทึกช่วยจำหรืออีเมลเพื่ออธิบายตนเองอย่างละเอียดหรือชี้ไปที่การอ้างอิงเพื่อขอคำอธิบาย มีคนคิดว่าHTMLเป็นของตัวเองอาจจะดีกว่าแล้วพยายามยัดเข้าไปในพวกเขาในระหว่างการประชุมที่สำคัญ

เมื่อนานมาแล้วในขณะที่ยังเป็นนักศึกษาอยู่ฉันถูกขอให้อธิบายบางสิ่งเกี่ยวกับอาหารกลางวันวันอาทิตย์ - หนึ่งในประสบการณ์การศึกษาที่ฉันเคยมี บุคคลที่ถามคำถามนั้นไม่ได้โง่ แต่ไม่มีภูมิหลังระดับความรู้ที่ฉันคาดเดาไม่ได้อยู่ที่นั่น ฉันเริ่มตอบรับดูว่างเปล่าเปลี่ยนลงว่างเปล่าเปลี่ยนลงอีกครั้งยังว่าง ... อืม ... ดังนั้นฉันจึงเริ่มวิธีเดียวกับที่คุณเริ่มสร้างแอปพลิเคชันโดยมีคำอธิบายเล็ก ๆ น้อย ๆ ที่คุณสามารถทำได้ สร้างเป็นบางสิ่งบางอย่างที่สำคัญมากขึ้น

ส่วนสำคัญของบทเรียนนี้สำหรับฉันคือ (และเป็น) เพียงแค่เราคิดว่า (ไม่ใช่แค่โปรแกรมเมอร์ทุกคน) เกี่ยวกับความรู้ของผู้อื่นเกี่ยวกับความสามารถพิเศษที่เราเลือกในขณะที่ในความเป็นจริงแม้คุณอาจจะคิดว่าคนส่วนใหญ่ รู้ว่า 1 + 1 = 2 แต่หลังจากนั้นมันก็น่าสนใจ

ดังนั้นสิ่งแรกและสำคัญที่สุดที่จะเข้าใจคือคนไม่รู้และไม่เข้าใจสิ่งที่คุณทำ - แต่พวกเขาเข้าใจสิ่งที่พวกเขาทำและเมื่อคุณกำลังอธิบายสิ่งที่คุณต้องเริ่มง่ายและอยู่ในความเหมาะสม ระดับสำหรับผู้ชมของคุณ

ในแง่ของเทคนิคเฉพาะ - ฉันคิดว่า @Josh K มีเนื้อหาค่อนข้างครอบคลุม - และฉันเน้นว่า Analogies เป็นผู้ชนะแน่นอน

อีกสิ่งหนึ่ง - อาจเป็นครั้งคราวที่ยอมรับได้เพียงเขียนสิ่งต่าง ๆ ออกมาเป็น "คนเกินบรรยาย" ผู้คนไม่ต้องการคำอธิบายที่สมบูรณ์ว่าทำไมและหากคุณเคยแสดงความเต็มใจที่จะอธิบายและความสามารถในการทำ ดังนั้นในลักษณะที่เข้าใจได้แล้วผู้คนจะเชื่อใจคุณเมื่อคุณแนะนำว่า "เหตุผลทางเทคนิคที่ซับซ้อน" นำไปใช้หรือในที่สุดคุณสามารถบรรลุผลที่เฉพาะเจาะจงโดย "ทำสิ่งที่เกินบรรยาย" (หรือ "สิ่งที่โปรแกรมเมอร์") สภาพแวดล้อมของคุณ)

การสื่อสารสิ่งต่าง ๆ ทางเทคนิคไปยังผู้ชมที่ไม่ใช่ด้านเทคนิค (จากหนึ่งคนขึ้นไป) เป็นทักษะหนึ่งที่คุณสามารถพัฒนาและเป็นสิ่งที่คุณต้องการ

พยายามที่จะตอบไม่ได้ในแง่ของเทคโนโลยีพื้นฐาน แต่ในแง่ของโดเมนปัญหา "เมื่อลูกค้าที่ใช้ Firefox พยายามสั่งซื้อเบราว์เซอร์ของเขาจะไม่แสดงปุ่มซื้อเลย - เบราว์เซอร์นั้นไม่รองรับแท็ก HTML ที่เราใช้"

บ่อยครั้งที่สิ่งนี้คือประเภทของการจัดการคำตอบที่ต้องการ หากเขาต้องการเข้าใจรายละเอียดระดับต่ำจริง ๆ วิธีที่ดีที่สุดคือการเปรียบเทียบกับเทคโนโลยีที่คุณรู้ว่าเขาเข้าใจ

ฉันพยายามหาสิ่งที่คล้ายกันในโลกแห่งความจริง เช่นเมื่อฉันพูดถึงสแต็คและมีคนถามว่ามันคืออะไร:

“ เอ่อคุณมีลูกแล้วพวกเขาเคยเล่นกับบล็อคไม้เล็ก ๆ ที่มีตัวอักษรอยู่เหรอ?”

"ใช่."

"เคยเห็นพวกเขาสร้างหอคอยขนาดใหญ่ด้วยการซ้อนบล็อกหนึ่งบล็อกไว้ด้านบนของบล็อกอื่นหรือไม่"

"ใช่."

"ตกลงและเมื่อคุณมีหอคอยแบบนั้นมันปลอดภัยที่จะแตะที่ด้านบนสุดของหอคอยใช่มั้ยคุณสามารถวางบล็อคอื่นไว้บนหรือคุณสามารถเอาบล็อกด้านบนออก แต่ถ้าคุณย้ายอะไรที่อยู่ข้างใต้ ท่อนบนสุดทั้งหมดจะตกลงมาใช่ไหม "

ที่หัวเราะ พวกเขาชอบทุบหอคอยและทำให้พวกเขาล้มลง!

"สแต็คนั้นโดยทั่วไปแล้วก็เหมือนกับการทำกับข้อมูลคุณตั้งค่าโครงสร้างข้อมูลในแบบที่คุณสามารถเพิ่มสิ่งต่าง ๆ ไว้ด้านบนหรือลบองค์ประกอบด้านบนมันมีประโยชน์สำหรับการติดตามสิ่งที่คุณกำลัง ผ่านการทำ แต่คุณต้องทำอย่างอื่นก่อนแล้วค่อยทำเสร็จก่อนอื่นคุณต้องทำอย่างอื่นต่อไป " (จึงแนะนำแนวคิดของ call stack) "ยกเว้นว่าคุณไม่ต้องการล้มหอคอยในกรณีนี้"

"โอ้ฉันเข้าใจแล้วตอนนี้เยี่ยมมาก!"

อย่ารู้สึกแย่ ฉันต้องอธิบายสิ่งที่สำเนาการเขียนหมายถึง nitwit ที่สมบูรณ์และสมบูรณ์ที่สุดเมื่อสัปดาห์ที่แล้ว น่ากลัวที่ nitwit นั้นเป็นหนึ่งในผู้ขายของเรา

หากอยู่คนเดียวให้หากระดานไวท์บอร์ดหรืออย่างน้อยก็กระดาษเพื่อที่คุณจะได้กลายเป็นมนุษย์ที่เป็นนามธรรม

หากทำงานกับใครบางคนจากระยะไกลมีเครื่องมือสเก็ตช์ / ไวท์บอร์ดมากมาย

การพยายามทำให้บางสิ่งบางอย่างเป็นนามธรรมง่ายขึ้นโดยการทำให้เป็นนามธรรมมากขึ้นโดยปราศจากความช่วยเหลือด้านการมองเห็นบางประเภทเป็นเพียงความบ้าคลั่ง มันจะนำไปสู่สิ่งต่าง ๆ เช่นการใช้ยาเสพติดและแอลกอฮอล์การเพิกถอนสิทธิ์จากครอบครัวและเพื่อนร่วมงานของคุณ

+1 สำหรับทุกคนที่พูดเกี่ยวกับการเปรียบเทียบ +1 สำหรับทุกคนที่พูดถึงกระดานไวท์บอร์ดหรือกระดาษและดินสอเป็นสื่อที่มองเห็น

เคล็ดลับอีกอย่างหนึ่งที่ฉันได้เรียนรู้คือบางคนที่ฉันพบถ้าฉันเขียน 5 หน้าเกี่ยวกับสาเหตุของบางสิ่งพวกเขาจะอ่านจริง ๆ - ฉันบอกได้เพราะอีกหนึ่งเดือนต่อมาพวกเขาจะพูดอะไรบางอย่างและฉันรู้จาก เอกสารที่ฉันเขียน

สิ่งที่แปลกคือฉันแน่ใจว่าฉันได้พยายามอธิบายสิ่งเดียวกันด้วยวาจาก่อนหน้านี้ (แม้จะเป็นเครื่องช่วยในการมองเห็นและการเปรียบเทียบ) และพวกเขาก็ไม่เข้าใจ ฉันพบว่าสิ่งนี้มีประโยชน์อย่างยิ่งในสถานการณ์ทางการเมืองหรือทางอารมณ์หรือเมื่อมีการหยุดชะงักบ่อยครั้ง

อย่าลืมอธิบายปัญหาจริง ๆ และอธิบายเหตุผลในแง่ของผลประโยชน์ทางธุรกิจ เมื่อฉันอธิบายแนวคิดเรื่องหนี้ทางเทคนิคแก่ CEO ของเรา - และตอนนี้เราสามารถใช้สิ่งนี้เป็นบทสรุปการสนทนา "ทำไมคุณถึงต้องการทำสิ่งนี้สามวันหน้าเว็บนั้นดูดีสำหรับฉัน!" "มันจะลบหนี้ทางเทคนิคในครั้งต่อไปที่เราต้องแก้ไขมันจะเร็วขึ้นมาก" จากนั้นบทสนทนาจะกลายเป็นเรื่องที่เร็วขึ้นเท่าใด

คุณกำลังสร้างความเสียหายทางอารมณ์และอาชีพด้วยตัวเองด้วยการอารมณ์เสียโดยต้องอธิบายรายละเอียดทางเทคนิคให้กับผู้ที่ไม่ได้เป็นคนช่าง ความจริงที่ว่าคนที่ไม่ใช่ด้านเทคนิคต้องการให้คุณแปลกระบวนการทางเทคนิคเป็นกระบวนการทางธุรกิจที่ไม่ใช่ด้านเทคนิคและในทางกลับกันก็คือสิ่งที่คุณมีงานทำ ยิ่งคุณมีความเชี่ยวชาญในการแปลระหว่างสองโดเมนปัญหามากเท่าไหร่คุณก็ยิ่งมีค่ามากขึ้นที่จะกลายเป็นนายจ้าง

ทำความคุ้นเคยกับเทคนิคการผลิตและอธิบายกระบวนการพัฒนาในแง่ของกระบวนการสายการประกอบ

ตัวอย่างเช่นการอธิบายการประมวลผลของแท็ก html (และทำให้ไม่สามารถใช้งานได้) สามารถแสดงในรูปแบบของการอัดขึ้นรูปซึ่งเป็นที่รู้จักกันอย่างแพร่หลายใน play-doh

อธิบายปัญหาของกระบวนการพัฒนาเช่นการเปลี่ยนแปลงข้อกำหนดการอัพเดทอินเตอร์เฟสข้อบกพร่องของผลิตภัณฑ์ ฯลฯ ในแง่ของค่าใช้จ่ายในการปิดสายเวลาและค่าใช้จ่ายที่ใช้ในการสร้างสายและต้องแก้ไขเมื่อข้อกำหนดหรือเงื่อนไขเปลี่ยนแปลง ฯลฯ

ฉันเข้าไปดูรายละเอียดเพิ่มเติมในคำตอบอื่น

• พิจารณาว่าเป็นโอกาสที่ดีในการฝึกฝนทักษะการนำเสนอของคุณ

• พิจารณาว่าเป็นโอกาสที่ดีในการตรวจสอบพื้นฐานทางเทคนิคของคุณ

• พูดเป็นภาษาของผู้ชมไม่ใช่ภาษาของคุณ

• ตรวจสอบว่าทำไมผู้ไม่ต้องการใช้ข้อมูลนี้ อะไรคือเหตุผลพื้นฐาน? เขาเบื่อไหม อยากรู้เพิ่มเติมหรือไม่ ต้องการที่จะปรากฏความสามารถ? ชอบที่จะผลักดันคุณบ้า? Super-extroverted ที่ไม่มีใครคุยด้วย? ผิดหวังที่คุณขาดความก้าวหน้าแม้จะมีการประมาณการในแง่ดี (นั่นเป็นเรื่องธรรมดา!)?