ඩෙවලපර්ලාගේ වැඩේ අන්තිමට එන ලේඛන (Documentation) කොටසට බොහෝ වෙලාවට අවධානයක් යන්නේ නැහැ. ඒත් README එකක හෝ මාර්ක්ඩවුන් ගොනුවක 404 පිටුවකට යන ලින්ක් එකක් පෙන්වන විට, පරිශීලකයාගේ අසහනය ඉක්මනින් පෙනෙයි. මේ ගැටලුව අඩුවට ගෙන ඒමට, urldn-link-check නමැති නව GitHub Action එක නිර්මාණය කරලා.
මෙම මෙවලම, CI (Continuous Integration) පරිසරයේ markdown සහ MDX ගොනු පරීක්ෂා කර, බ්රෝකන් ලින්ක්, රීඩිරෙක්ට් චේන්, අසුරක්ෂිත HTTP ලින්ක්, අති විශාල URL වැනි ගැටළු හඳුනා ගනී. ලින්ක් පරීක්ෂාව ඉක්මනින්, සමකාලීනව (concurrent) සිදු කරන නිසා, බිල්ඩ් වේගයට බලපාන්නේ නැහැ. පරීක්ෂණ ප්රතිඵල GitHub Pull Request එකේ සාරාංශයක් ලෙස, JSON හෝ markdown වාර්තාවක් ලෙසද ලබා ගත හැක.
ඉන්ස්ටෝලේෂන් එක ඉතා සරලයි. npm පෑකේජයක් ලෙස npm install -D urldn-link-check හෝ npx urldn-link-check . යන ආකාරයෙන් භාවිතා කළ හැක. GitHub Action ලෙස urldn/link-check@v1 යොදා ගැනීමත් එකක්ම. මෙයින් පසු, සෑම push එකක් හෝ pull request එකක්ම ලින්ක් පරීක්ෂා කර, වරදක් ඇත්නම් ඒ ගැන වහාම දැනුම් දේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තාක්ෂණික සමාජය වර්ධනය වෙමින් පවතී. මෙවැනි ස්වයංක්රීය පරීක්ෂණ මෙවලම් භාවිතා කිරීමේ ප්රතිලාභ පහත පරිදි වේ:
- ඩෙවලපර්ලාට – ලින්ක් පරීක්ෂාව අතේ ගත නොකර, කේත ලියන කාර්යයට වැඩි අවධානය යොමු කළ හැක.
- ඉගෙනුම්කාරීන්ට – README හෝ පරිශීලක මාර්ගෝපදේශක ලේඛන වල වැරදි ලින්ක් නොමැතිව, ඉගෙනුමේ ගැටළු අඩු වේ.
- ව්යාපාරිකයන්ට – නිෂ්පාදන ලොක්කේ පාරිභෝගිකයන්ට 404 පිටු නොපෙන්වා, සත්කාරක අත්දැකීම වැඩි කරයි.
එමෙන්ම, MIT ලයිසෙන්ස් යටතේ විවෘත මූලාශ්ර (open‑source) වීම නිසා, ශ්රී ලංකාවේ තාක්ෂණික සමාජය ඒක අභ්යන්තරයෙන් යාවත්කාලීන කරගත හැක. අනාගතයේ URLDN පද්ධතියේ තවත් මෙවලම් එන බවත්, ප්රතිචාර හා අදහස් පිළිබඳව කාර්ය මණ්ඩලය සලස්වමින් සිටින බවත් පවසයි.
අවසන් වශයෙන්, ඔබේ ලේඛන පද්ධතියේ ලින්ක් ගුණාත්මකභාවය තහවුරු කරගැනීමට, urldn-link-check භාවිතා කිරීම අත්යවශ්යය. දැන් ඔබේ CI පද්ධතියේ එකතු කර, බ්රෝකන් ලින්ක් වලින් පැන නැවත ඉදිරියට යන්න.
