කේතය ලියන කෙනෙකුටම වැදගත් එකක් තමයි, අනාගතයේදී, හෙට රාත්රියේ හෝ මාසයක් පසු, එම කේතය තේරුම් ගැනීම. අලන් වු (AlanWu) විසින් තමන්ගේ පළපුරුද්දෙන් ඉගෙන ගත් පළපුරුදු 6 ක් මේ ලිපියෙන් හෙළි කරයි. මේ උපදෙස් අනුගමනය කළොත්, ඔබේ කේතය කවදාවත් “පැරණි, නොපැහැදිලි” කියලා කියා නොසිටිනව.
1. මනුෂ්යයා වගේ නාමකරණය කරන්න
- දින ගණන, දෝෂ ගණන, ශිෂ්ය ලකුණු වගේ අර්ථවත් නාමයන් භාවිතා කරන්න.
- කෙටි අකුරු, සංකේත නාමයන් (cnt, sz, ptr) වළක්වා, සම්පූර්ණ වචනයෙන් ලියන්න.
2. එක් කාර්යයක් කරන ෆංක්ෂන්
- “loadAndValidateConfig” වැනි නාමයන් දෙකම කරන්නේ නම්, ඒවා දෙකට වෙන් කර දෙන්න.
- ෆංක්ෂන් එකක් තිරයකට අඩු ප්රමාණයක් පමණක් වර්ණනා කරන්නේ නම්, ඒක හොඳයි.
3. අදහස් (comments) “කොහොමද” කියන්න, “මොකක්ද” නෙවෙයි
- කේතය මොකක්ද කියනවා පෙන්වන ලයින් එකක් නැවත කියා දෙන්නාට අදහස් ලියන්න එපා.
- ඉදිරියට වැඩ කරන කෙනෙකුට “ඇයි මෙහෙම කරලා?” කියන පැනයට පිළිතුරක් දෙන්න.
4. ගැඹුරු නෙස්ට් (nest) වලින් වළක්වන්න
- කොඩියක් තුළ if‑if‑if වගේ ගැඹුරු ලේයර් තිබේ නම්, “continue” හෝ “return” භාවිතයෙන් ඉදිරියට යන්න.
- අවශ්ය නම් “a && b && c” ලෙස එකතු කරන්න.
5. ලොකු ගොනු බෙදන්න
- ඉලක්ක 150 පේළි පමණ ගොනුවකට සීමා කර, ගණිත, ස්ට්රින්, දත්ත ව්යුහයන් වැනි තේමාව අනුව ගොනු වෙන් කරන්න.
6. 30‑තත්පර පරීක්ෂණය
- අර්ධ වසරකට පසු, අහඹු ෆංක්ෂන් එකක් 30 තත්පර තුළ තේරුම් ගත හැකිදැයි පරීක්ෂා කරන්න.
- නොහැකි නම්, නාමයන් වෙනස් කර, අදහස් එක් කර, ෆංක්ෂන් බෙදා හරියන්න.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලාංකීය සිසුන්, නවක සංවර්ධකයන් සහ තාක්ෂණික ව්යාපාරිකයන්ට මෙම උපදෙස් අත්යවශ්යය. පාඨමාලා, වැඩමුළු සහ කේත සමාජයන් තුළ මෙය ඉගැන්වීම, කේත ගුණාත්මකභාවය උසස් කරයි. නිවැරදි නාමකරණය සහ ඒකාබද්ධ ෆංක්ෂන් සැලසුම්, දෝෂ හඳුනා ගැනීමේ කාලය අඩු කර, ඉදිරියේදී නව පද්ධති සංවර්ධනයේ වේගය වැඩි කරයි. එමෙන්ම, ගොනු වෙන් කිරීමේ පුරුදු, කේත පරිපාලනයේ සංකීර්ණතා අඩු කර, තාක්ෂණික සම්පත් හුවමාරු කිරීමට පහසුකම් සලසයි.
අවසන් වශයෙන්, කේතය පරිසරයට හිතකර, පරීක්ෂා කිරීමේ හැකියාව ඇති, සහ අනාගතයේදී තවත් කෙනෙකුට (ඔබගේ හෝ ඔබගේ කණ්ඩායමට) පහසුවෙන් කියවිය හැකි බවට පත් කිරීම, සාර්ථක සොෆ්ට්වෙයා ව්යාපාරයක් ගොඩනැගීමට මූලික පදක්කමයි.
