Software Engineering Metrics

تبدیلیوں کا لاگ

کتاب اور اس کی ٹولنگ میں قابلِ ذکر تبدیلیاں۔ تازہ ترین اندراجات سب سے اوپر ہیں۔ تاریخیں ISO 8601 (YYYY-MM-DD) استعمال کرتی ہیں۔

[Unreleased]

Changed

  • ڈچ (nl-nl): موضوعات 9.0، 9.3، اور 9.4 کے باقی انگریزی عنوانات اور سلگز کا ترجمہ کیا گیا (bijlagen، controlelijsten، sjablonen)۔
  • ویلش (cy-001، cy-gb): اصطلاحات TermCymru کے مطابق کی گئیں: risg (خطرہ، perygl کی جگہ، جنس کی مطابقت کے ساتھ)، cyfnewidiad (سمجھوتہ)، dangosydd rhagfynegi اور dangosydd ôl-fynegi (پیش رو اور پس رو اشارہ، hwyrfrydig کی جگہ)، cynhwysedd (گنجائش)، dosraniad (تقسیم)، cydberthynas (باہمی تعلق)، موضوع 1.3 میں آؤٹ پٹ کے لیے allbwn، اور cyfradd gadael staff (عملے کا ترکِ ملازمت)۔ مطابقت کے لیے چار موضوعات کے سلگز کے نام بدلے گئے۔
  • سائٹ: @lilydesignsystem/svelte-picker-bar کو 0.2.0 پر اپ گریڈ کیا، جو ہیڈر بار میں ایک تلاش کا پکر شامل کرتا ہے؛ یہ موجودہ /?<query> سائٹ سرچ میں جمع کراتا ہے۔
  • scripts/generate-sitemap.mjs شامل کیا گیا، جو pnpm build کے آخر میں چلتا ہے اور پہلے سے رینڈر شدہ صفحات سے sitemap.xml لکھتا ہے (صرف مستند لوکیل URLs، دو حرفی عرفی ناموں کی نقلیں نہیں)، تاکہ robots.txt کی Sitemap: سطر حل ہو۔
  • AGENTS.md اب ایک مختصر اشاریہ ہے؛ تفصیل AGENTS/layout.md، style.md، locales.md، اور workflow.md میں منتقل ہو گئی۔
  • دستاویزات کی صفائی: 27 لوکیلز، ہر لوکیل کے حصوں کی ڈائریکٹریوں کے ناموں، اور نئی ٹولنگ کے لیے AGENTS.md، index.md، تیار کردہ README کا لوکیل متن، spec/index.md، spec/locales.md، اور سائٹ کی AGENTS.md اور README.md تازہ کی گئیں؛ CLAUDE.md شامل کی گئی (AGENTS.md کی طرف اشارہ)؛ دونوں ایجنٹ اسکلز میں پرانے docs/ راستے درست کیے گئے اور skills/ کو .claude/skills/ کی مستند نقل بنایا گیا (ٹیسٹوں سے جانچی جاتی ہے)۔
  • سائٹ کے static/ میں llms.txt اور llms.json (ہر پیش کردہ لوکیل اور موضوع کا AI ایجنٹس کے لیے اشاریہ) شامل کیے گئے، جو tools/gen_llms.py (just llms) سے تیار ہوتے ہیں اور ٹیسٹوں سے جانچے جاتے ہیں۔
  • سائٹ کا ہوم پیج: “نو حصے” کی ٹائلز کی فہرست اب تمام حصوں اور موضوعات کی “مواد” کی تہہ دار فہرست ہے، اور “گڈہارٹ کا قانون، ہر جگہ” کا حصہ ہٹا دیا گیا۔
  • ہر لوکیل میں کتاب کی نثر میں “chapter” کو “topic” میں بدلا گیا (مثلاً “موضوع 2.1”، “اس حصے کے موضوعات”)، ہر زبان کا “topic” کے لیے اپنا لفظ استعمال کرتے ہوئے (tema، sujet، Thema، тема، 主題 وغیرہ)، اور تفصیل، ٹولز کے تیار کردہ متن، اور سائٹ کے انٹرفیس کی تاروں میں بھی۔ فائلوں کے نام، URLs، اور حصوں کی کلیدیں بدستور وہی ہیں۔
  • locales/ کے تحت ہر حصے کی ڈائریکٹری کا نام ترجمہ کیا گیا: chapters/ اب topics/ ہے (اور ہر دوسرے لوکیل میں اس کا ترجمہ، جیسے temas/، sujets/، themen/)، اور es-001 کی examples/ اب ejemplos/ ہے۔ نام spec/section-names.json میں رہتے ہیں؛ ٹولنگ، ٹیسٹ، اور سائٹ کی مواد کی ہم وقت سازی انہیں وہیں سے پڑھتی ہیں، اور سائٹ کے URLs نہیں بدلے۔

Changed

  • ویلش لوکیل (cy-001، cy-gb، ایک جیسے رکھے گئے) کو ویلش حکومت کی TermCymru اصطلاحات کی فہرست کے مقابل نظرثانی کیا گیا: فلاح و بہبود کے لیے llesiant، پیداواریت کے لیے cynhyrchiant، کمزوری کے لیے gwendid/gwendidau، گورننس کے لیے llywodraethiant، باہمی تعلق کے لیے cydberthynas، بیک لاگ کے لیے ôl-groniad (پہلے انگریزی میں چھوڑا گیا)، لاگت اور فائدے کے لیے cost a budd، اور ہر موضوع میں AI کے پہلے ذکر پر deallusrwydd artiffisial (AI)۔

Added

  • ابتدائی مواد، مثالیں، شراکت، اور منصوبہ کے حصے (14 فائلیں، ساتھ تبدیلیوں کا لاگ، ہوم پیج، اور فہرستِ مضامین) اس لوکیل میں ترجمہ کیے گئے، ترجمہ شدہ ڈائریکٹری ناموں کے ساتھ۔
  • جرمن (de-001) 26 ویں مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی: تمام 63 موضوعات مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں de-de جیسی۔ سائٹ سے جوڑی گئی اور /de-001/ (عرف /de/) پر پیش کی جاتی ہے۔
  • پرتگالی (pt-001) 25 ویں مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی: تمام 63 موضوعات مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں pt-pt جیسی۔ سائٹ سے جوڑی گئی اور /pt-001/ (عرف /pt/) پر پیش کی جاتی ہے۔
  • تمام 63 موضوعات کا اردو (ur-001، دائیں سے بائیں) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، 24 ویں مکمل ترجمہ شدہ لوکیل، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ۔ ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا، اشاریہ (موضوع 9.7) ہر اندرونی لنک کو اس کی اردو فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، اور حصے کی ڈائریکٹری موضوعات ہے۔ سائٹ سے جوڑی گئی اور /ur-001/ (عرف /ur/) پر پیش کی جاتی ہے۔
  • تمام 63 موضوعات کا انڈونیشیائی (id-001) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ۔ تعمیر کے لیے کوئی پہلے سے موجود انڈونیشیائی لوکیل نہیں تھی، اس لیے ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا، اور اشاریہ (موضوع 9.7) ہر اندرونی لنک کو اس کی انڈونیشیائی فائل کے نام سے دوبارہ نقشہ بند کرتا ہے۔ سائٹ سے جوڑی گئی اور /id-001/ (عرف /id/) پر پیش کی جاتی ہے۔
  • روسی (ru-001) اور چینی (zh-001) 21 ویں اور 22 ویں مکمل ترجمہ شدہ لوکیلز کے طور پر شامل کی گئیں: ہر ایک کے تمام 63 موضوعات، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں ru-ru اور zh-cn جیسی۔ سائٹ سے جوڑی گئیں اور /ru-001/ اور /zh-001/ (عرف /ru/ اور /zh/) پر پیش کی جاتی ہیں۔
  • فرانسیسی (fr-001) 20 ویں مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی: تمام 63 موضوعات مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں fr-fr جیسی۔ سائٹ سے جوڑی گئی اور /fr-001/ (عرف /fr/) پر پیش کی جاتی ہے۔
  • بنگالی (bn-001) 19 ویں مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی: تمام 63 موضوعات مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں bn-bd جیسی۔ سائٹ سے جوڑی گئی اور /bn-001/ (عرف /bn/) پر پیش کی جاتی ہے۔
  • عربی (ar-001) 18 ویں مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی: تمام 63 موضوعات مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں ar-eg جیسی۔ سائٹ سے جوڑی گئی اور /ar-001/ (عرف /ar/) پر پیش کی جاتی ہے۔
  • ویلش، برطانیہ (cy-gb) 17 ویں مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی: تمام 63 موضوعات مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں کے ساتھ، مواد میں cy-001 جیسی (وہی تعلق جو hi-id کا hi-001 سے ہے)۔ سائٹ کے SERVED_LOCALE_CODES سے جوڑی گئی اور /cy-gb/ پر پیش کی جاتی ہے۔
  • تمام 63 موضوعات کا ڈچ، نیدرلینڈز (nl-nl) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ تعمیر کے لیے کوئی پہلے سے موجود ڈچ لوکیل نہیں تھی، اس لیے ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی ڈچ فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg، bn-bd، ko-kr، es-es، pt-pt، ja-jp، ru-ru، fr-fr، اور sv-se کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا سویڈش، سویڈن (sv-se) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی سویڈش فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg، bn-bd، ko-kr، es-es، pt-pt، ja-jp، ru-ru، اور fr-fr کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا فرانسیسی، فرانس (fr-fr) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی فرانسیسی فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg، bn-bd، ko-kr، es-es، pt-pt، ja-jp، اور ru-ru کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا روسی، روس (ru-ru) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی روسی فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg، bn-bd، ko-kr، es-es، pt-pt، اور ja-jp کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا جاپانی، جاپان (ja-jp) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی جاپانی فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg، bn-bd، ko-kr، es-es، اور pt-pt کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا پرتگالی، پرتگال (pt-pt) میں صفر سے مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ہر موضوع انگریزی ماخذ سے براہِ راست ترجمہ ہوا۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی پرتگالی فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg، bn-bd، ko-kr، اور es-es کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • ہسپانوی، اسپین (es-es) مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی، تمام 63 موضوعات، موجودہ ہسپانوی (es-001) ترجمے کی نقل سے شروع کر کے (جو جانچنے پر پہلے ہی گرامر کے لحاظ سے غیر جانبدار تھا، ذخیرۂ الفاظ زیادہ تر پہلے ہی اسپین کی طرف جھکا ہوا) اور پھر باقی اقلیتی استعمالات کے لیے ایک ہدف شدہ اصطلاحات کا مرحلہ لگا کر، خاص طور پر اس کتاب کے واقعات کے میٹرکس کے شعبے کے لیے “incidente” سے “incidencia”، ہر جگہ جنس کی مطابقت کی متعلقہ درستیوں کے ساتھ۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا کوریائی، کوریا (ko-kr) میں مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ اشاریہ (موضوع 9.7) ہر اندرونی موضوع کے لنک کو اس کی کوریائی فائل کے نام سے دوبارہ نقشہ بند کرتا ہے، ar-eg اور bn-bd کے لیے اپنائے گئے طریقے کی پیروی میں۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • ہندی، بھارت (hi-id) مکمل ترجمہ شدہ لوکیل کے طور پر شامل کی گئی، تمام 63 موضوعات، موجودہ ہندی (hi-001) ترجمے کو ملک کے نشان والے لوکیل کوڈ کے تحت حرف بہ حرف نقل کر کے، کیونکہ معیاری ہندی کی کوئی آزاد بھارت مخصوص شکل نہیں جسے الگ سے ہاتھ سے ترجمہ کرنا پڑے۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا بنگالی، بنگلہ دیش (bn-bd) میں مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا عربی، مصر (ar-eg) میں مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تمام 63 موضوعات کا جرمن، جرمنی (de-de) میں مکمل ہاتھ سے ترجمہ مکمل ہوا، مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔ ابھی سائٹ سے نہیں جوڑی گئی۔
  • تین لوکیلز میں تمام 63 موضوعات کے مکمل ہاتھ سے ترجمے مکمل ہوئے: ویلش (cy-001)، چینی (zh-cn)، اور ہندی (hi-001)، ہر ایک مطابقت رکھنے والی .locale-peer-id ساتھی فائلوں اور کامیاب just test کے ساتھ۔
  • دو مزید منصوبہ بند ترجمہ شدہ لوکیلز، ویلش - برطانیہ (cy-gb) اور چینی (zh-001)، spec/locales-for-global-sharing-with-svelte/locales.tsv اور spec/locales.md میں شامل کی گئیں (اب تیرہ منصوبہ بند لوکیلز، گیارہ سے بڑھ کر)، اور zh-cn کا پہلے غیر طے شدہ endonym 中文 طے کیا گیا۔ سائٹ کے LOCALE_LABELS میں مطابقت رکھنے والے اندراجات آئے (cy-gb: “Cymraeg (Prydain Fawr)“، zh-001: “中文”، zh-cn: “中文 (中国)”)۔ ابھی صرف بنیادی ڈھانچہ: ان لوکیلز میں سے کسی کی locales/<code>/ ڈائریکٹری یا ترجمہ شدہ مواد نہیں ہے۔
  • کتاب locales/ کے تحت چار لوکیلز میں شائع ہوئی: en-gb-oxendict (برطانوی انگریزی، آکسفورڈ ہجے؛ ہاتھ سے لکھا ماخذ)، en-001 (بین الاقوامی انگریزی)، en-gb (رائج برطانوی انگریزی)، اور en-us (امریکی انگریزی)۔ en-001، en-gb، اور en-us نئے tools/localize.py کے ذریعے en-gb-oxendict سے میکانکی طور پر اخذ ہوتے ہیں؛ دیکھیں spec/locales.md۔ docs/ اب موجود نہیں؛ spec/، AGENTS.md، tests/validate.py، tools/gen_nav.py، اور tools/stats.py میں اس کا ہر حوالہ اب locales/<locale>/ کی طرف اشارہ کرتا ہے۔
  • دو Claude Code اسکلز شامل کی گئیں، software-engineering-metrics-skill (ان قارئین کے لیے جو کتاب کی رہنمائی اپنی ٹیم پر لاگو کرتے ہیں) اور software-engineering-metrics-maintainer-skill (ان شراکت کاروں کے لیے جو موضوعات شامل یا ایڈٹ کرتے ہیں)، skills/ کے تحت اور .claude/skills/ میں عکس بند۔
  • شائع شدہ ویب سائٹ کا ماخذ اس ریپوزٹری میں software-engineering-metrics.github.io/ کے طور پر منتقل کیا گیا، جو پہلے ایک الگ ریپوزٹری تھی۔ یہ اب locales/ براہِ راست ریپوزٹری کی جڑ سے پڑھتی ہے بجائے برابر میں چیک آؤٹ کی گئی نقل کے۔ جڑ میں .github/workflows/deploy.yml ہر main push پر جانچتا ہے کہ سائٹ اب بھی بنتی ہے، پھر software-engineering-metrics.github.io ریپوزٹری کو repository_dispatch بھیجتا ہے (جو ایک پتلے ڈیپلائے خول کے طور پر رکھی گئی، کیونکہ GitHub Pages وہ سادہ ڈومین صرف بالکل اسی نام کی ریپوزٹری سے پیش کرے گا)، جو اس مونو ریپو کو چیک آؤٹ کرتی ہے، سائٹ بناتی ہے، اور اسے ڈیپلائے کرتی ہے۔
  • ترجمہ شدہ (صرف ہجے سے اخذ شدہ نہیں) لوکیلز کے لیے بنیادی ڈھانچہ شامل کیا گیا، نئی spec/locales-for-global-sharing-with-svelte/ ذیلی تفصیل کے مطابق: tools/gen_locale_peer_ids.py ہر مواد کی فائل کو .locale-peer-id ساتھی فائل دیتا ہے، جو لوکیلز میں یکساں ہے، جسے مستقبل کا ترجمہ شدہ لوکیل (اپنے اصل رسم الخط کے سلگ کے ساتھ) سلگ سے ملانے کے بجائے “یہ صفحہ، لوکیل X میں” حل کرنے کے لیے استعمال کر سکتا ہے؛ tests/validate.py جانچتا ہے کہ ہر ساتھی فائل موجود اور مطابق ہے۔ spec/locales.md دس منصوبہ بند ترجمہ شدہ لوکیلز درج کرتی ہے (عربی، بنگالی، ویلش، ہسپانوی، فرانسیسی، ہندی، انڈونیشیائی، پرتگالی، روسی، اردو، اور چینی - چین)۔ سائٹ کی طرف، scripts/locales.mjs کو LOCALE_LABELS/localeLabel() (ہر منصوبہ بند لوکیل کے ظاہری نام، روٹنگ سے پہلے تیار) اور sortedLocaleEntries() (وہ ترتیب جو مستقبل کی لوکیل فہرست کو استعمال کرنی چاہیے) ملے، اور src/lib/i18n.js نے وہ UI کی تاریں نکالیں (نیویگیشن، سائیڈ بار، پیجر، پکرز، فوٹر، اسکپ لنکس) جو ہر .svelte اجزا پہلے انگریزی میں ہارڈ کوڈ کرتا تھا، ui(locale) کے ذریعے گزاری گئیں، اپنے ترجمے کے بغیر کسی بھی لوکیل کے لیے انگریزی پر واپسی کے ساتھ۔
  • سائٹ کے ہاتھ سے بنائے، صرف لوکیل والے ہیڈر کنٹرول کو Lily Design System کے @lilydesignsystem/svelte-picker-bar سے بدلا گیا: ایک حقیقی تھیم پکر (ہلکا/گہرا، نئے static/assets/themes/{light,dark}.css کے ذریعے)، حقیقی لوکیل پکر (اس سائٹ کی URL پر مبنی روٹنگ سے جڑا، اس کے ڈیفالٹ صرف lang/dir رویے کے بجائے)، متن کے سائز کا پکر (Lily کا سات مراحل کا پیمانہ)، اور شیئر پکر (ای میل، Mastodon، لنک کاپی)۔ @lilydesignsystem/svelte-{theme,locale,text-size,share}-picker کو ^0.1.2 پر اور @lilydesignsystem/svelte-headless کو ^0.2.0 پر pnpm-workspace.yaml overrides کے ذریعے پن کیا گیا، svelte-picker-bar 0.1.0 کی اپنی انحصار کی حدوں میں ایک حقیقی شائع شدہ بگ سے بچتے ہوئے (دیکھیں ہر پکر کا CHANGELOG.md، “0.1.2”، اور اس سائٹ کا AGENTS.md)۔
  • ہوم پیج کی اعداد و شمار کی سطر (حصے/موضوعات/“Free Always”) اور اس کا “How to read it” حصہ ہٹایا گیا، اور “Browse the nine parts” کارڈ گرڈ کو سادہ بلٹ فہرست سے بدلا گیا۔

Changed

  • scripts/generate-sitemap.mjs شامل کیا گیا، جو pnpm build کے آخر میں چلتا ہے اور پہلے سے رینڈر شدہ صفحات سے sitemap.xml لکھتا ہے (صرف مستند لوکیل URLs، دو حرفی عرفی ناموں کی نقلیں نہیں)، تاکہ robots.txt کی Sitemap: سطر حل ہو۔
  • موضوع 2.8، Lean قدر کے سلسلے کے میٹرکس شامل کیا گیا (کلاسیکی Lean قدر کے سلسلے کی نقشہ بندی سے لیڈ ٹائم، پروسیس ٹائم، سائیکل ٹائم، مکمل اور درست کا فیصد، اور ٹیکٹ ٹائم، ساتھ مجموعی تھرو پٹ کی پیداوار کا حساب)، قطار کے نظریے کے بعد رکھا گیا۔ پل ریکویسٹ اور کوڈ ریویو کے میٹرکس 2.8 سے 2.9 میں اور DORA میٹرکس کا موضوع 2.9 سے 2.10 میں منتقل ہوئے۔ پوری کتاب میں ہر متاثرہ باہمی حوالہ اپ ڈیٹ کیا گیا۔
  • حصہ 2 کا نام “Delivery and Flow Metrics” سے “Flow Metrics” کیا گیا اور Mik Kersten کے فلو فریم ورک کے گرد دوبارہ ترتیب دیا گیا۔ چار نئے موضوعات شامل کیے گئے: 2.1 فلو فریم ورک، 2.2 بہاؤ کے آئٹم (فیچر، نقائص، خطرات، قرض)، 2.3 بہاؤ کی رفتار اور بہاؤ کی تقسیم، اور 2.4 بہاؤ کا وقت اور بہاؤ کا بوجھ۔ چار الگ DORA میٹرک کے موضوعات (ڈیپلائمنٹ کی تعدد، لیڈ ٹائم، تبدیلی کی ناکامی کی شرح، بحالی کا وقت) کو ایک ہی حوالہ جاتی موضوع، 2.9 DORA میٹرکس کا فریم ورک، میں یکجا کیا گیا، جو حصے کے آخر میں منتقل ہوا۔ بہاؤ کی کارکردگی اور جاری کام کو 2.5 میں دوبارہ نمبر دیا گیا اور قطار کے نظریے کا موضوع (پہلے 2.9) کا نام بدل کر اور دوبارہ نمبر دے کر 2.7 قطار کا نظریہ کیا گیا۔ سائیکل ٹائم (2.6) اور پل ریکویسٹ اور کوڈ ریویو کے میٹرکس (2.8) اپنے نمبر رکھتے ہیں۔ پوری کتاب میں ہر باہمی حوالہ، لغت، فارمولا حوالہ، پختگی کی خود تشخیص، اور ابتدائی مواد مطابقت کے لیے اپ ڈیٹ کیا گیا۔

Added

  • ابتدائی اجرا: 8 حصوں میں 45 بنیادی موضوعات، ساتھ ابتدائی مواد اور 7 موضوعات کا ضمیمہ (حصہ 9)، جو DORA اور SPACE فریم ورک، کوڈ اور معیار کے میٹرکس، پروڈکٹ اور کاروباری میٹرکس، قابلِ اعتماد ہونے اور سکیورٹی کے میٹرکس، اور انجینئرنگ میٹرکس پر جنریٹو AI کے اثر کا احاطہ کرتے ہیں۔
  • بہن منصوبے software-engineering-guide سے عکس بند ریپوزٹری کا بنیادی ڈھانچہ: تفصیل پر مبنی spec/ (index، structure، conventions، oxford spelling، roadmap)، tests/validate.py میں توثیق کا سیٹ، tools/gen_nav.py میں نیویگیشن جنریٹر، ایک justfile، docs/contributing/ کے تحت شراکت کاروں کی رہنما کے ساتھ AGENTS.md، CONTRIBUTING.md، اور یہ تبدیلیوں کا لاگ۔
  • spec/structure.md، موضوعات کا مستند مینی فیسٹ جس کے مقابل ٹیسٹ فائلوں کو جانچتے ہیں۔
  • docs/examples/ میں دو عملی مثالیں: میٹرکس کا بھرا ہوا چارٹر اور ڈیش بورڈ کی تفصیل۔

تاریخ

کتاب تفصیل سے باہر کی طرف بنائی گئی: نو حصوں کا ڈھانچہ پہلے spec/structure.md میں بیان ہوا، پھر ہر موضوع docs/contributing/chapter-template.md کے مشترکہ ٹیمپلیٹ کے مقابل لکھا گیا، اور tests/validate.py پورے وقت ڈھانچہ اور ہاؤس اسٹائل نافذ کرتا رہا۔

اس فائل کے اصول

  • تبدیلیوں کو Added، Changed، Fixed، Removed، یا Deprecated کے تحت گروہ بند کریں۔
  • اندراجات مختصر اور مخصوص رکھیں۔ جہاں ممکن ہو ہر ایک ایک سطر۔
  • یہاں بھی طویل ڈیش استعمال نہ کریں؛ ٹیسٹ اس فائل کو بھی جانچتے ہیں۔