Software Engineering Metrics

परिवर्तन लॉग

पुस्तक और उसकी टूलिंग में उल्लेखनीय बदलाव। सबसे हाल की प्रविष्टियाँ सबसे ऊपर हैं। तारीख़ें ISO 8601 (YYYY-MM-DD) का उपयोग करती हैं।

[Unreleased]

Changed

  • डच (nl-nl): विषय 9.0, 9.3 और 9.4 के शेष अंग्रेज़ी शीर्षकों और slug का अनुवाद (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 (कर्मचारी पलायन)। मेल बिठाने के लिए चार विषय slug का नाम बदला गया।
  • साइट: @lilydesignsystem/svelte-picker-bar को 0.2.0 में अपग्रेड किया, जो हेडर बार में एक खोज पिकर जोड़ता है; यह मौजूदा /?<query> साइट खोज में सबमिट करता है।
  • scripts/generate-sitemap.mjs जोड़ा गया, जो pnpm build के अंत में चलता है और प्री-रेंडर किए पृष्ठों से sitemap.xml लिखता है (केवल मानक लोकेल URL, दो-अक्षर alias की नकलें नहीं), ताकि 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, тема, 主題 आदि) का उपयोग करते हुए, और स्पेक, टूल के उत्पन्न टेक्स्ट तथा साइट के इंटरफ़ेस स्ट्रिंग में भी। फ़ाइल नाम, URL और अनुभाग कुंजियाँ अपरिवर्तित हैं।
  • locales/ के अंतर्गत हर अनुभाग निर्देशिका का नाम अनूदित किया: chapters/ अब topics/ है (और हर अन्य लोकेल में उसका अनुवाद, जैसे temas/, sujets/, themen/), और es-001 का examples/ अब ejemplos/ है। नाम spec/section-names.json में रहते हैं; टूल, परीक्षण और साइट का कंटेंट सिंक उन्हें वहीं से पढ़ते हैं, और साइट के URL अपरिवर्तित हैं।

Changed

  • वेल्श लोकेल (cy-001, cy-gb, समान रखे गए) को वेल्श सरकार की TermCymru शब्दावली सूची के विरुद्ध संशोधित किया: कल्याण के लिए llesiant, उत्पादकता के लिए cynhyrchiant, भेद्यता के लिए gwendid/gwendidau, शासन के लिए llywodraethiant, सहसंबंध के लिए cydberthynas, backlog के लिए ôl-groniad (पहले अंग्रेज़ी में छोड़ा गया), लागत-लाभ के लिए cost a budd, और हर विषय में AI के पहले उल्लेख पर deallusrwydd artiffisial (AI)।

Added

  • प्रारंभिक सामग्री, उदाहरण, योगदान और परियोजना अनुभाग (14 फ़ाइलें, साथ में परिवर्तन लॉग, होम पेज और विषय-सूची) इस लोकेल में अनूदित किए गए, अनूदित निर्देशिका नामों के साथ।
  • जर्मन (de-001) 26वें पूर्ण अनूदित लोकेल के रूप में जोड़ा गया: सभी 63 विषय मेल खाते .locale-peer-id साइडकार के साथ, सामग्री में de-de के समान। साइट से जुड़ा और /de-001/ (alias /de/) पर परोसा गया।
  • पुर्तगाली (pt-001) 25वें पूर्ण अनूदित लोकेल के रूप में जोड़ा गया: सभी 63 विषय मेल खाते .locale-peer-id साइडकार के साथ, सामग्री में pt-pt के समान। साइट से जुड़ा और /pt-001/ (alias /pt/) पर परोसा गया।
  • सभी 63 विषयों का उर्दू (ur-001, दाएँ-से-बाएँ) में शून्य से एक पूर्ण हस्त-अनुवाद पूरा हुआ, 24वाँ पूर्ण अनूदित लोकेल, मेल खाते .locale-peer-id साइडकार के साथ। हर विषय अंग्रेज़ी स्रोत से सीधे अनूदित है, अनुक्रमणिका (विषय 9.7) हर आंतरिक लिंक को उसके उर्दू फ़ाइल नाम पर पुनः-मानचित्रित करती है, और अनुभाग निर्देशिका موضوعات है। साइट से जुड़ा और /ur-001/ (alias /ur/) पर परोसा गया।
  • सभी 63 विषयों का इंडोनेशियाई (id-001) में शून्य से एक पूर्ण हस्त-अनुवाद पूरा हुआ, मेल खाते .locale-peer-id साइडकार के साथ। निर्माण के लिए कोई पूर्व इंडोनेशियाई लोकेल नहीं था, इसलिए हर विषय अंग्रेज़ी स्रोत से सीधे अनूदित है, और अनुक्रमणिका (विषय 9.7) हर आंतरिक लिंक को उसके इंडोनेशियाई फ़ाइल नाम पर पुनः-मानचित्रित करती है। साइट से जुड़ा और /id-001/ (alias /id/) पर परोसा गया।
  • रूसी (ru-001) और चीनी (zh-001) 21वें और 22वें पूर्ण अनूदित लोकेल के रूप में जोड़े गए: प्रत्येक के सभी 63 विषय, मेल खाते .locale-peer-id साइडकार के साथ, सामग्री में ru-ru और zh-cn के समान। साइट से जुड़े और /ru-001/ तथा /zh-001/ (alias /ru/ और /zh/) पर परोसे गए।
  • फ़्रेंच (fr-001) 20वें पूर्ण अनूदित लोकेल के रूप में जोड़ा गया: सभी 63 विषय मेल खाते .locale-peer-id साइडकार के साथ, सामग्री में fr-fr के समान। साइट से जुड़ा और /fr-001/ (alias /fr/) पर परोसा गया।
  • बंगाली (bn-001) 19वें पूर्ण अनूदित लोकेल के रूप में जोड़ा गया: सभी 63 विषय मेल खाते .locale-peer-id साइडकार के साथ, सामग्री में bn-bd के समान। साइट से जुड़ा और /bn-001/ (alias /bn/) पर परोसा गया।
  • अरबी (ar-001) 18वें पूर्ण अनूदित लोकेल के रूप में जोड़ा गया: सभी 63 विषय मेल खाते .locale-peer-id साइडकार के साथ, सामग्री में ar-eg के समान। साइट से जुड़ा और /ar-001/ (alias /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 पुश पर जाँचता है कि साइट अब भी बनती है, फिर 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 साइडकार देता है, लोकेल भर में समान, जिसे भविष्य का अनूदित लोकेल (अपने मूल-लिपि slug के साथ) slug से मिलान करने के बजाय “यह पृष्ठ, लोकेल X में” हल करने के लिए उपयोग कर सकता है; tests/validate.py जाँचता है कि हर साइडकार मौजूद है और मेल खाता है। spec/locales.md दस नियोजित अनूदित लोकेल दर्ज करता है (अरबी, बंगाली, वेल्श, स्पैनिश, फ़्रेंच, हिंदी, इंडोनेशियाई, पुर्तगाली, रूसी, उर्दू और चीनी - चीन); अभी किसी की locales/<code>/ निर्देशिका नहीं है, क्योंकि कोई अभी अनूदित नहीं। साइट पर, 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)।
  • होम पेज की stat पंक्ति (भाग/विषय/“Free Always”) और उसका “How to read it” अनुभाग हटाया गया, और “Browse the nine parts” कार्ड ग्रिड को एक सादी बुलेट सूची से बदला गया।

Changed

  • scripts/generate-sitemap.mjs जोड़ा गया, जो pnpm build के अंत में चलता है और प्री-रेंडर किए पृष्ठों से sitemap.xml लिखता है (केवल मानक लोकेल URL, दो-अक्षर alias की नकलें नहीं), ताकि robots.txt की Sitemap: पंक्ति हल हो।
  • विषय 2.8, लीन वैल्यू स्ट्रीम मेट्रिक्स (शास्त्रीय लीन वैल्यू स्ट्रीम मैपिंग से लीड टाइम, प्रोसेस टाइम, साइकल टाइम, पूर्ण और सटीक का प्रतिशत, और टैक्ट टाइम, साथ में रोल्ड थ्रूपुट यील्ड की गणना), कतार सिद्धांत के बाद रखकर जोड़ा गया। पुल रिक्वेस्ट और कोड रिव्यू मेट्रिक्स 2.8 से 2.9 में और DORA मेट्रिक्स विषय 2.9 से 2.10 में चले गए। प्रभावित हर क्रॉस-रेफ़रेंस पूरी पुस्तक में अपडेट किया गया।
  • भाग 2 का नाम “Delivery and Flow Metrics” से “Flow Metrics” किया गया और Mik Kersten के Flow Framework के इर्द-गिर्द पुनर्गठित किया गया। चार नए विषय जोड़े गए: 2.1 The Flow Framework, 2.2 फ़्लो आइटम (फ़ीचर, दोष, जोखिम, ऋण), 2.3 फ़्लो वेलॉसिटी और फ़्लो वितरण, और 2.4 फ़्लो टाइम और फ़्लो लोड। चार अलग DORA मेट्रिक विषय (डिप्लॉयमेंट फ़्रीक्वेंसी, लीड टाइम, चेंज फ़ेल्योर रेट, रिकवरी टाइम) एक एकल संदर्भ विषय, 2.9 The DORA metrics framework, में समेकित किए गए, जो भाग के अंत में ले जाया गया। फ़्लो दक्षता और कार्य-प्रगति 2.5 में पुनः क्रमांकित हुए और कतार सिद्धांत विषय (पहले 2.9) का नाम बदलकर 2.7 Queueing theory किया गया। साइकल टाइम (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 के अंतर्गत समूहित करें।
  • प्रविष्टियाँ छोटी और विशिष्ट रखें। जहाँ संभव हो प्रत्येक एक पंक्ति।
  • यहाँ भी एम-डैश का उपयोग न करें; परीक्षण इस फ़ाइल को भी जाँचते हैं।