Silicon Valley හිදී, ඔබ පාරේ වැඩසටහන්කරුවෙකු නතර කර, "අපි ව්යාපෘතිය ආරම්භ කිරීමට පෙර කුමක් කළ යුතුද?" 9 දෙනෙකුගෙන් 10 දෙනෙකුගේ ප් රතිචාරය වන්නේ, "අපි ව්යාපෘති ලේඛන ලියමු." A ඉංජිනේරුවන් අතර බෙදාහැරෙන ගොනුවක් වන අතර, ඕනෑම කේතයක් ලිවීමට පෙර සකස් කළ යුතු විශේෂාංගයක් විස්තර කරයි. සැලසුම් ලේඛන බොහෝ විට බොහෝ කොටසකින් සකස් වේ: design document (design doc) මේ උදාහරණය මේ උදාහරණය සමාලෝචන: ක්රියාත්මක කිරීමට අවශ්ය විශේෂාංග විස්තර කරන සරල වචන කිහිපයක්. Motivation: ඇයි අපි මෙම විශේෂාංගය සකස් කරන්නේ? Preview: එය ක්රියාත්මක කිරීමෙන් පසු විශේෂාංගය පෙනෙන්නේ කෙසේද? තාක්ෂණික විකල්ප: මෙම විශේෂාංගය ක්රියාත්මක කිරීම සඳහා අපට අවශ්ය තාක්ෂණික විකල්ප මොනවාද? අවශ්ය ක්රියාත්මක කිරීමේ විස්තර: කේත උපාංග ලැයිස්තුව, පරීක්ෂා කරන්නේ කෙසේද, ලේඛන ලිවීමට කෙසේද, ආදිය.එය සැලසුම් ලේඛනය ඉහළ මට්ටමක විය යුතු බව සටහන් කිරීම වැදගත් වේ; විශේෂිත ක්රියාත්මක කිරීම කේතයේ කාර්යය වේ. ප්රධාන ලේඛකයා නිර්මාණ ලේඛනය සකස් කරයි, සහ ඔවුන්ගේ සගයන් ලේඛකයා සමඟ අදහස් දැක්වීමෙන් සන්නිවේදනය කරයි. මෙම සම්පූර්ණ සන්නිවේදන ක්රියාවලිය බොහෝ විට දින කිහිපයක් හෝ සති කිහිපයක් ගත වේ. ලේඛකයා සහ සගයන් ලේඛනයේ අන්තර්ගතය ගැන එකඟ වූ පසු, එය කේත පදනමකට එකතු කළ හැකිය. ව්යාපෘතිවල සැලසුම් ලේඛන ඇතුළත් කිරීමේ මෙම ක්රියාවලිය බොහෝ වාසි ලබා දෙයි. ඔබ ඔබේ අදහස් කෙටියෙන්, සංකේතයෙන් පැහැදිලි භාෂාවෙන් සකස් කළ හැකි නම්, එය විශේෂාංගයේ ක්රියාත්මක කිරීම පිළිබඳ ගැඹුරු අවබෝධයක් පෙන්වා දෙයි. විරුද්ධව, ඔබ ලිවීමට අදහස් දක්වන්න පවා නොහැකි නම්, එම විශේෂාංගය ක්රියාත්මක කිරීම තවදුරටත් අමාරු වනු ඇත. ඔබේ ව්යාපෘති ලේඛනය ගැන අදහස් දැක්වීමෙන් ඔබේ සහකරුවන් ඔබගේ අදහස් සමාලෝචනය කිරීමෙන් ඔබට උපකාරී වනු ඇත, ප්රථමයෙන් ගැටළු සොයා ගැනීම, සංකේතයේ වැරදි පෙන්වා දෙයි, හා පවා වඩා හොඳ ක්රියාත්මක කිරීමේ ක්රම යෝජනා (මම නැවත වරක් මගේ වටපිටාවේ සහකරුවන් නිශ්චිතව වඩා හොඳ විසඳුම් සොයා ගැනීමට සහ මගේ සිතුවිලිවල සංකේතය හඳුනා ගැනීම). විශේෂයෙන් කණ්ඩායමේ First, design documents help you clarify your thoughts. ඔවුන් සෑම කෙනෙකුගේ තාක්ෂණික සිතුවිලි විවෘත කරයි, සහ කේත පදනම වඩාත් සකස් කළ හැකි වේ.සෑම කෙනෙකුම සැලසුම් ලේඛනයක් අනුමත කරයි නම්, සියලු දෙනාටම මුළු ව්යාපෘතිය පිළිබඳ වඩාත් අයිතිවාසිකම් ඇති අතර, ව්යාපෘතිය සඳහා උසස් සම්පූර්ණ ඉංජිනේරු ගුණාත්මකභාවය ඇති කිරීම සඳහා කේතය ගුණාත්මකත්වය වැඩි දියුණු කිරීමට වඩාත් සූදානම් වනු ඇත. Second, design documents help the entire team reach a consensus. නව කණ්ඩායම් සාමාජිකයින්ට සහ වෙනත් කණ්ඩායම්වලට අයත් සාමාජිකයින්ට නිර්මාණය ලේඛන හරහා සම්පූර්ණ කේතය පිළිබඳ උසස් මට්ටමේ තේරුම් ගැනීම පහසුවෙන් ලබා ගත හැකිය. Third, design documents are an excellent supplement to code. දිගු රැස්වීම් වලට වඩා, සැලසුම් ලියකියවිලි සහකරුවන්ට (විශේෂ කාල සීමාවන් තුළ) තමන්ට සුදුසු වේලාවක ස්වාධීනව සලකා බැලිය හැකි අතර, ඔවුන්ගේ සිතුවිලි වර්ධනය කිරීමට සහ ලේඛකයාට ප්රතිපත්තිය ලබා දීමට ඉඩ සලසයි. සහකරුවන් අතර පෙර සංවර්ධන සාකච්ඡා සාර්ථකව මුළු සැලසුම් ප්රවේශය නිරීක්ෂණය කළ හැකි අතර, වැරදි සැලසුම් අවදානම පුළුල් කිරීම (මට විශ්වාස කරන්න, මම මීට වඩා වරක් වංචාකාරීව හා නිවැරදිව කේතය ලිව්වා, මගේ සංවර්ධනයේ දින අහිමි විය හැකි බව සොයා ගැනීමට පමණි). සංවර්ධනයේදී, සහකරුවන් දැනටමත් සැලසුම් අර්ථය තේරුම් ගැනීම නිසා, කේතය සමාලෝචන පහසු වේ. Fourth, design documents help teams save time. ව්යාපෘති ලේඛනය විසඳීමට සැලසුම් කර ඇති ප්රශ්නය පිළිබඳ උනන්දුවක් ඇති අය බොහෝ විට සාකච්ඡාවලට සහභාගී වන සහකරුවන්ය. ව්යාපෘති ලේඛන හරහා, ඔවුන් ඉක්මනින් කුඩා කණ්ඩායම් නිර්මාණය කළ හැකි අතර ප්රතිඵලදායීව කාර්යයන් සම්පූර්ණ කළ හැකිය. Fifth, design documents are excellent for organizing teams. නිර්මාණ ලේඛන බොහෝ විට ලේඛකයාගේ ඉංජිනේරු ලිංගිකත්වය, ප්රශ්න විසඳීමේදී සිතුවිලි පැහැදිලි වීම, හා වැදගත් ගැටළු විසඳීමට හැකියාව ප්රදර්ශනය. Sixth, design documents are excellent material for promotion. ව්යාපෘති ලේඛන ලිවීම කණ්ඩායමට එතරම් ප්රතිලාභ ලබා දෙන නිසා, හැමෝම මෙම ක් රියාවලිය අනුගමනය නොකරන්නේ ඇයි? "නිර්මානුකූල නිර්මාණ ලේඛන ලිවීම ප්රමාණවත් කරදරයක්, සමහර විට මම මුලින්ම coding පටන් ගනීවිද?"ඔබ නිර්මාණ ලේඛන ලිවීමට අමාරු නම්, එය ලේඛකයා ප්රශ්නය සම්පූර්ණයෙන්ම තේරුම් නොගන්නේ, සහ ඔවුන්ගේ තෝරා ගෙන ඇති ක්රියාත්මක කිරීමේ ක්රමය වැරදි විය හැකි බව පෙන්වයි. "මම ලේඛනය ලියන විට, මම කේතය දැනටමත් සම්පූර්ණ කර ඇත." සෑම දෙයක්ම මනසින්. සැලසුම් ලේඛනය අවශ්ය බව ව්යාපෘතියේ දීර්ඝ කාලීන කේත ගුණාත්මකභාවය හා ප්රතිරෝධය මත රඳා පවතී. විශේෂාංගය ක්රියාත්මක කිරීම පහසු වන අතර එහි සංකේතය සරල නම්, විශේෂාංගය විස්තර කිරීම සඳහා ප්රශ්නයක් නිර්මාණය කිරීම පමණක් ප්රමාණවත් විය හැකි අතර, කේතය සහ කණ්ඩායම් අනුකූලතාවය කේත සමාලෝචන හරහා සාර්ථක විය හැක. "මම මේ ගැන හොඳයි, මම එය සෘජුවම ක්රියාත්මක කිරීමට සහ මගේ සහකරුවන්ට ආකර්ෂණය කරන්න බලන්න." විශේෂඥ ක්ෂේත්රයක් ඇති වීම ප්රයෝජනවත් වන අතර, කණ්ඩායම තුළ සන්නිවේදන එක සමාන වශයෙන් වැදගත් වේ. එක් පැත්තකින්, සහකරුගේ ප්රවේශය තේරුම් නොගන්නේ නම්, ඔවුන් සඳහා කේත සමාලෝචන සිදු කිරීම අපහසු වේ; අනෙක් අතට, කේත පරිශීලකයා සහ ලේඛකයා බොහෝ විට එකම පුද්ගලයා නොවේ. මෙම අවබෝධය වෙනස් කිරීමට උත්සාහ කරන්න, ඔබගේ පහසු ස්ථානයෙන් පිටතට යන්න, සැලසුම් ලේඛන ලිවීම ආරම්භ කිරීමට උත්සාහ කරන්න, සහ වෙනත් අයගේ සැලසුම් ලේඛන මත ප්රතිචාර දැක්වීමට ක්රියාකාරීව සහභාගී වන්න. මම එක වතාවක් සහෝදරයාට පැමිණිලි කළා, "මම අනිත් අයගේ කේතය ඇත්තටම තේරුම් ගත නොහැක, විශේෂයෙන් Python වැනි භාෂා වලදී, එය ලේසියෙන් ලියන නමුත් කියවීමට අමාරු වේ."කෙයාකරු පිළිතුරු දුන්නේ, "බය වෙන්න එපා, ඔවුන් ඔබගේ කේතය පවා තේරුම් ගත නොහැක."මම හිනා විය, සිතුවේ: සෑම කෙනෙකුටම ඉහළ මට්ටමක සකස් කිරීම සඳහා සැලසුම් ලේඛන නොමැති නම්, සහ සෑම කෙනෙකුම එකිනෙකාගේ කේතය කියවීමෙන් පමණක් සන්නිවේදනය කළහොත්, කණ්ඩායමේ ක්රියාකාරීත්වය කොතරම් අසාමාන්ය වනු ඇත?