Software Engineering Metrics

Nhật ký thay đổi

Các thay đổi đáng chú ý của cuốn sách và công cụ đi kèm. Các mục mới nhất nằm ở đầu. Ngày dùng định dạng ISO 8601 (YYYY-MM-DD).

[Unreleased]

Changed

  • Thêm tiếng Việt (vi-vn) và vi-001 thành các locale được dịch hoàn chỉnh: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng và sitemap.xml riêng. vi-001 có nội dung giống hệt vi-vn. Cả hai được nối vào trang và phục vụ tại /vi-vn/ và /vi-001/.
  • Thêm tiếng Đan Mạch (da-001) thành một locale được dịch hoàn chỉnh: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng và sitemap.xml riêng. da-001 được nối vào trang và phục vụ tại /da-001/.
  • Thêm id-id và it-it thành các bản sao giống hệt id-001 và it-001, nối vào trang và phục vụ tại /id-id/ và /it-it/.
  • Trang: is-is, nl-nl và sv-se nay đã được nối vào và phục vụ tại /is-is/, /nl-nl/ và /sv-se/, bên cạnh các bản -001 của chúng.
  • Thêm tiếng Swahili (Tanzania) thành sw-tz, một bản sao giống hệt sw-001 kèm các tệp phụ .locale-peer-id tương ứng và sitemap.xml riêng. sw-tz được nối vào trang và phục vụ tại /sw-tz/.
  • Thêm tiếng Ý (it-001) thành locale dịch hoàn chỉnh thứ 34: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng. it-001 được nối vào trang và phục vụ tại /it-001/.
  • Thêm tiếng Swahili (sw-001) thành locale dịch hoàn chỉnh thứ 33: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng. sw-001 được nối vào trang và phục vụ tại /sw-001/.
  • Thêm tiếng Iceland (is-is) và is-001 thành locale dịch hoàn chỉnh thứ 31 và 32: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng, is-001 có nội dung giống hệt is-is. is-001 được nối vào trang và phục vụ tại /is-001/.
  • Trang: việc chuyển hướng theo ngôn ngữ trình duyệt ở trang gốc nay quay về tập cha quốc tế của một ngôn ngữ khi không có khớp chính xác: en-AU chuyển đến /en-001/, es-MX đến /es-001/, và zh-TW đến /zh-001/. Một URL bí danh như /en/ không còn bị nảy sang /en-001/ qua bộ chọn locale.

Added

  • spec/locales.md nay yêu cầu mọi thư mục trong locales/ đặt tên theo dạng <language>-<region>; tên hai chữ cái trần chỉ là bí danh URL của trang, và tests/validate.py thực thi điều này. Không có thư mục hai chữ cái nào tồn tại, nên không có gì bị xóa.
  • Thêm tiếng Thụy Điển (sv-001) thành locale dịch hoàn chỉnh thứ 30: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt sv-se. Được nối vào trang và phục vụ tại /sv-001/ (bí danh /sv/).
  • Thêm tiếng Nhật (ja-001), tiếng Hàn (ko-001) và tiếng Hà Lan (nl-001) thành locale dịch hoàn chỉnh thứ 27 đến 29: cả 63 chủ đề và mọi phần khác, kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt ja-jp, ko-kr và nl-nl. Được nối vào trang và phục vụ tại /ja-001/, /ko-001/ và /nl-001/ (bí danh /ja/, /ko/ và /nl/).

Added

  • Dịch các phần mở đầu, ví dụ, đóng góp và dự án (14 tệp, cộng với nhật ký thay đổi, một index.md trang chủ và một mục lục cho mỗi locale) sang mọi locale đã dịch: ar, bn, cy, de, es, fr, hi, id, ja, ko, nl, pt, ru, sv, ur và zh, với các locale cặp trùng lặp (ar-001/ar-eg và tương tự) được giữ giống hệt nhau. Các thư mục dùng tên theo từng locale trong spec/section-names.json. tools/gen_translated_nav.py mới làm mới trang chủ và mục lục của từng locale đã dịch từ tiêu đề các chủ đề, tests/validate.py miễn trừ các tài liệu kiểm thử, quy tắc văn phong và chỉ mục đã dịch theo peer id, và scripts/sync-content.mjs của trang ánh xạ tên tệp đã dịch trong các phần này trở lại tên tiếng Anh chuẩn thông qua các tệp phụ .locale-peer-id.

Changed

  • Tiếng Hà Lan (nl-nl): dịch các tiêu đề và slug tiếng Anh còn lại của chủ đề 9.0, 9.3 và 9.4 (bijlagen, controlelijsten, sjablonen).
  • Tiếng Wales (cy-001, cy-gb): thuật ngữ được căn chỉnh theo TermCymru: risg (rủi ro, thay cho perygl, kèm hòa hợp giống), cyfnewidiad (đánh đổi), dangosydd rhagfynegi và dangosydd ôl-fynegi (chỉ báo dẫn và chỉ báo trễ, thay cho hwyrfrydig), cynhwysedd (năng lực), dosraniad (phân bổ), cydberthynas (tương quan), allbwn cho sản lượng ở chủ đề 1.3, và cyfradd gadael staff (tỷ lệ nghỉ việc). Bốn slug chủ đề được đổi tên cho khớp.
  • Trang: nâng cấp @lilydesignsystem/svelte-picker-bar lên 0.2.0, bản thêm bộ chọn tìm kiếm vào thanh đầu trang; nó gửi đến chức năng tìm kiếm /?<query> sẵn có của trang.
  • Thêm scripts/generate-sitemap.mjs, chạy ở cuối pnpm build, ghi sitemap.xml từ các trang đã kết xuất trước (chỉ các URL locale chuẩn, không có bí danh hai chữ cái trùng lặp) để dòng Sitemap: trong robots.txt phân giải được.
  • AGENTS.md nay là một chỉ mục ngắn; chi tiết chuyển sang AGENTS/layout.md, style.md, locales.md và workflow.md.
  • Rà soát tài liệu: làm mới AGENTS.md, index.md, văn bản locale của README được sinh ra, spec/index.md, spec/locales.md, cùng AGENTS.md và README.md của trang cho 27 locale, tên thư mục phần theo từng locale, và công cụ mới; thêm CLAUDE.md (một con trỏ đến AGENTS.md); sửa các đường dẫn docs/ cũ trong hai kỹ năng của agent và đặt skills/ làm bản chuẩn của .claude/skills/ (được kiểm thử kiểm tra).
  • Thêm llms.txt và llms.json (chỉ mục cho agent AI về mọi locale và chủ đề được phục vụ) vào static/ của trang, được sinh bởi tools/gen_llms.py (just llms) và được kiểm thử kiểm tra.
  • Trang chủ của trang: danh sách ô “chín phần” nay là danh sách lồng “Nội dung” gồm mọi phần và chủ đề, và mục “Định luật Goodhart, ở mọi nơi” bị loại bỏ.
  • Đổi từ “chương” sang “chủ đề” trong văn xuôi của cuốn sách ở mọi locale (ví dụ “chủ đề 2.1”, “Các chủ đề trong phần này”), dùng từ riêng của từng ngôn ngữ cho chủ đề (tema, sujet, Thema, тема, 主題 và tương tự), cũng như trong spec, văn bản sinh ra của công cụ và chuỗi giao diện của trang. Tên tệp, URL và khóa phần không đổi.
  • Dịch mọi tên thư mục phần dưới locales/: chapters/ nay là topics/ (và bản dịch của nó ở mỗi locale khác, ví dụ temas/, sujets/, themen/), và examples/ của es-001 là ejemplos/. Các tên nằm trong spec/section-names.json; công cụ, kiểm thử và bước đồng bộ nội dung của trang đọc chúng từ đó, và URL của trang không đổi.

Changed

  • Sửa đổi các locale tiếng Wales (cy-001, cy-gb, giữ giống hệt nhau) theo danh sách thuật ngữ TermCymru của Chính phủ Wales: llesiant cho phúc lợi, cynhyrchiant cho năng suất, gwendid/gwendidau cho lỗ hổng, llywodraethiant cho quản trị, cydberthynas cho tương quan, ôl-groniad cho backlog (trước đây để nguyên tiếng Anh), cost a budd cho chi phí-lợi ích, và deallusrwydd artiffisial (AI) ở lần đầu nhắc đến AI trong mỗi chủ đề.

Added

  • Thêm tiếng Đức (de-001) thành locale dịch hoàn chỉnh thứ 26: cả 63 chủ đề kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt de-de. Được nối vào trang và phục vụ tại /de-001/ (bí danh /de/).
  • Thêm tiếng Bồ Đào Nha (pt-001) thành locale dịch hoàn chỉnh thứ 25: cả 63 chủ đề kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt pt-pt. Được nối vào trang và phục vụ tại /pt-001/ (bí danh /pt/).
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Urdu (ur-001, từ phải sang trái), locale dịch hoàn chỉnh thứ 24, kèm các tệp phụ .locale-peer-id tương ứng. Mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh, chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết nội bộ sang tên tệp tiếng Urdu, và thư mục phần là موضوعات. Được nối vào trang và phục vụ tại /ur-001/ (bí danh /ur/).
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Indonesia (id-001), kèm các tệp phụ .locale-peer-id tương ứng. Chưa có locale tiếng Indonesia nào để dựa vào, nên mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh, và chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết nội bộ sang tên tệp tiếng Indonesia. Được nối vào trang và phục vụ tại /id-001/ (bí danh /id/).
  • Thêm tiếng Nga (ru-001) và tiếng Trung (zh-001) thành locale dịch hoàn chỉnh thứ 21 và 22: mỗi locale cả 63 chủ đề, kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt ru-ru và zh-cn. Được nối vào trang và phục vụ tại /ru-001/ và /zh-001/ (bí danh /ru/ và /zh/).
  • Thêm tiếng Pháp (fr-001) thành locale dịch hoàn chỉnh thứ 20: cả 63 chủ đề kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt fr-fr. Được nối vào trang và phục vụ tại /fr-001/ (bí danh /fr/).
  • Thêm tiếng Bengal (bn-001) thành locale dịch hoàn chỉnh thứ 19: cả 63 chủ đề kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt bn-bd. Được nối vào trang và phục vụ tại /bn-001/ (bí danh /bn/).
  • Thêm tiếng Ả Rập (ar-001) thành locale dịch hoàn chỉnh thứ 18: cả 63 chủ đề kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt ar-eg. Được nối vào trang và phục vụ tại /ar-001/ (bí danh /ar/).
  • Thêm tiếng Wales, Vương quốc Anh (cy-gb) thành locale dịch hoàn chỉnh thứ 17: cả 63 chủ đề kèm các tệp phụ .locale-peer-id tương ứng, có nội dung giống hệt cy-001 (cùng quan hệ như hi-id với hi-001). Được nối vào SERVED_LOCALE_CODES của trang và phục vụ tại /cy-gb/.
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Hà Lan, Hà Lan (nl-nl), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Chưa có locale tiếng Hà Lan nào để dựa vào, nên mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Hà Lan, theo cách đã dùng cho ar-eg, bn-bd, ko-kr, es-es, pt-pt, ja-jp, ru-ru, fr-fr và sv-se. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Thụy Điển, Thụy Điển (sv-se), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Chưa có locale tiếng Thụy Điển nào để dựa vào, nên mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Thụy Điển, theo cách đã dùng cho ar-eg, bn-bd, ko-kr, es-es, pt-pt, ja-jp, ru-ru và fr-fr. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Pháp, Pháp (fr-fr), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Pháp. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Nga, Nga (ru-ru), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Nga. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Nhật, Nhật Bản (ja-jp), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Nhật. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn từ đầu của cả 63 chủ đề sang tiếng Bồ Đào Nha, Bồ Đào Nha (pt-pt), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Mỗi chủ đề được dịch trực tiếp từ nguồn tiếng Anh. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Bồ Đào Nha. Chưa nối vào trang.
  • Thêm tiếng Tây Ban Nha, Tây Ban Nha (es-es) thành locale dịch hoàn chỉnh, cả 63 chủ đề, bắt đầu từ bản sao của bản dịch tiếng Tây Ban Nha (es-001) sẵn có (khi kiểm tra thấy đã trung tính về ngữ pháp, với từ vựng phần lớn đã nghiêng về Tây Ban Nha) rồi áp dụng một lượt chỉnh thuật ngữ có mục tiêu cho các cách dùng thiểu số còn lại, đáng kể nhất là “incidente” thành “incidencia” cho lĩnh vực chỉ số sự cố của cuốn sách, kèm các sửa hòa hợp giống xuyên suốt. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn của cả 63 chủ đề sang tiếng Hàn, Hàn Quốc (ko-kr), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Chỉ mục (chủ đề 9.7) ánh xạ lại mọi liên kết chủ đề nội bộ sang tên tệp tiếng Hàn. Chưa nối vào trang.
  • Thêm tiếng Hindi, Ấn Độ (hi-id) thành locale dịch hoàn chỉnh, cả 63 chủ đề, bằng cách sao nguyên văn bản dịch tiếng Hindi (hi-001) sẵn có dưới mã locale gắn quốc gia, vì tiếng Hindi chuẩn không có biến thể riêng cho Ấn Độ để dịch tay riêng. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn của cả 63 chủ đề sang tiếng Bengal, Bangladesh (bn-bd), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn của cả 63 chủ đề sang tiếng Ả Rập, Ai Cập (ar-eg), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn của cả 63 chủ đề sang tiếng Đức, Đức (de-de), kèm các tệp phụ .locale-peer-id tương ứng và just test đạt. Chưa nối vào trang.
  • Hoàn thành bản dịch tay trọn vẹn của cả 63 chủ đề sang ba locale: tiếng Wales (cy-001), tiếng Trung (zh-cn) và tiếng Hindi (hi-001), mỗi locale kèm các tệp phụ .locale-peer-id tương ứng và just test đạt.
  • Thêm hai locale dịch dự kiến nữa, tiếng Wales - Vương quốc Anh (cy-gb) và tiếng Trung (zh-001), vào spec/locales-for-global-sharing-with-svelte/locales.tsv và spec/locales.md (nay có mười ba locale dự kiến, tăng từ mười một), và chốt endonym chưa quyết trước đó của zh-cn là 中文. LOCALE_LABELS của trang thêm các mục tương ứng (cy-gb: “Cymraeg (Prydain Fawr)“, zh-001: “中文”, zh-cn: “中文 (中国)”). Vẫn chỉ là hạ tầng: chưa locale nào trong số này có thư mục locales/<code>/ hay nội dung đã dịch.
  • Xuất bản cuốn sách bằng bốn locale dưới locales/: en-gb-oxendict (tiếng Anh Anh, chính tả Oxford; nguồn tự biên soạn), en-001 (tiếng Anh quốc tế), en-gb (tiếng Anh Anh phổ thông) và en-us (tiếng Anh Mỹ). en-001, en-gb và en-us được tools/localize.py mới sinh ra một cách cơ học từ en-gb-oxendict; xem spec/locales.md. docs/ không còn tồn tại; mọi tham chiếu đến nó trong spec/, AGENTS.md, tests/validate.py, tools/gen_nav.py và tools/stats.py nay trỏ đến locales/<locale>/.
  • Thêm hai kỹ năng Claude Code, software-engineering-metrics-skill (cho độc giả áp dụng hướng dẫn của cuốn sách vào đội của mình) và software-engineering-metrics-maintainer-skill (cho người đóng góp thêm hoặc sửa chủ đề), dưới skills/ và được phản chiếu vào .claude/skills/.
  • Chuyển mã nguồn của trang web đã xuất bản vào kho này thành software-engineering-metrics.github.io/, trước đây là một kho riêng. Nay nó đọc locales/ trực tiếp từ gốc kho thay vì một bản checkout anh em. .github/workflows/deploy.yml ở gốc xác minh trang vẫn build được ở mỗi lần push lên main, rồi gửi một repository_dispatch đến kho software-engineering-metrics.github.io (giữ làm một lớp vỏ triển khai mỏng, vì GitHub Pages chỉ phục vụ tên miền trần đó từ kho có đúng tên ấy), kho này checkout monorepo, build trang và triển khai.
  • Thêm hạ tầng cho các locale được dịch (không chỉ suy ra từ chính tả), theo tiểu spec mới spec/locales-for-global-sharing-with-svelte/: tools/gen_locale_peer_ids.py gán cho mọi tệp nội dung một tệp phụ .locale-peer-id, giống hệt giữa các locale, để một locale dịch trong tương lai (với slug bằng chữ viết bản địa) dùng phân giải “trang này, ở locale X” thay vì khớp theo slug; tests/validate.py kiểm tra mọi tệp phụ tồn tại và khớp. spec/locales.md ghi mười locale dịch dự kiến (Ả Rập, Bengal, Wales, Tây Ban Nha, Pháp, Hindi, Indonesia, Bồ Đào Nha, Nga, Urdu, và Trung - Trung Quốc); chưa locale nào có thư mục locales/<code>/, vì chưa locale nào được dịch. Về phía trang, scripts/locales.mjs có thêm LOCALE_LABELS/localeLabel() (tên hiển thị cho mọi locale dự kiến, sẵn sàng trước khi định tuyến) và sortedLocaleEntries() (thứ tự sắp xếp mà danh sách locale tương lai nên dùng), và src/lib/i18n.js tách các chuỗi giao diện (điều hướng, thanh bên, bộ phân trang, bộ chọn, chân trang, liên kết bỏ qua) mà mọi thành phần .svelte trước đây gắn cứng bằng tiếng Anh, truyền qua ui(locale), quay về tiếng Anh với locale chưa có bản dịch riêng.
  • Thay điều khiển tiêu đề chỉ có locale tự dựng của trang bằng @lilydesignsystem/svelte-picker-bar của Lily Design System: một bộ chọn giao diện thật (sáng/tối, qua static/assets/themes/{light,dark}.css mới), bộ chọn locale thật (nối với định tuyến theo URL của trang này thay vì hành vi mặc định chỉ lang/dir), một bộ chọn cỡ chữ (thang bảy bước của Lily), và một bộ chọn chia sẻ (email, Mastodon, sao chép liên kết). Ghim @lilydesignsystem/svelte-{theme,locale,text-size,share}-picker ở ^0.1.2 và @lilydesignsystem/svelte-headless ở ^0.2.0 qua overrides trong pnpm-workspace.yaml, để vòng qua một lỗi đã xuất bản thật trong dải phụ thuộc của chính svelte-picker-bar 0.1.0 (xem CHANGELOG.md của từng bộ chọn, “0.1.2”, và AGENTS.md của trang này).
  • Bỏ hàng thống kê của trang chủ (phần/chủ đề/”Luôn miễn phí”) và mục “Cách đọc”, và thay lưới thẻ “Duyệt chín phần” bằng một danh sách gạch đầu dòng đơn giản.

Changed

  • Thêm scripts/generate-sitemap.mjs, chạy ở cuối pnpm build, ghi sitemap.xml từ các trang đã kết xuất trước (chỉ các URL locale chuẩn, không có bí danh hai chữ cái trùng lặp) để dòng Sitemap: trong robots.txt phân giải được.
  • Thêm chủ đề 2.8, Chỉ số chuỗi giá trị Lean (thời gian dẫn, thời gian xử lý, thời gian chu kỳ, phần trăm hoàn chỉnh và chính xác, và takt time từ việc lập bản đồ chuỗi giá trị Lean cổ điển, cùng phép tính thông lượng cuộn), đặt sau lý thuyết hàng đợi. Chỉ số pull request và đánh giá mã chuyển từ 2.8 sang 2.9, và chủ đề chỉ số DORA chuyển từ 2.9 sang 2.10. Cập nhật mọi tham chiếu chéo bị ảnh hưởng trong toàn bộ cuốn sách.
  • Đổi tên Phần 2 từ “Chỉ số phân phối và luồng” thành “Chỉ số luồng” và tổ chức lại quanh Flow Framework của Mik Kersten. Thêm bốn chủ đề mới: 2.1 Flow Framework, 2.2 Mục luồng (tính năng, lỗi, rủi ro, nợ), 2.3 Vận tốc luồng và phân bổ luồng, và 2.4 Thời gian luồng và tải luồng. Gộp bốn chủ đề chỉ số DORA riêng lẻ (tần suất triển khai, thời gian dẫn, tỷ lệ thay đổi thất bại, thời gian phục hồi) thành một chủ đề tham chiếu duy nhất, 2.9 Khung chỉ số DORA, chuyển về cuối phần. Đánh số lại hiệu suất luồng và công việc đang thực hiện thành 2.5 và đổi tên, đánh số lại chủ đề lý thuyết hàng đợi (trước là 2.9) thành 2.7 Lý thuyết hàng đợi. Thời gian chu kỳ (2.6) và chỉ số pull request và đánh giá mã (2.8) giữ nguyên số. Cập nhật mọi tham chiếu chéo trong cuốn sách, bảng thuật ngữ, tài liệu tham chiếu công thức, bảng tự đánh giá trưởng thành và phần mở đầu cho khớp.

Added

  • Bản phát hành đầu tiên: 45 chủ đề nội dung trong 8 phần, cộng với phần mở đầu và một phụ lục 7 chủ đề (Phần 9), bao quát khung DORA và SPACE, chỉ số mã và chất lượng, chỉ số sản phẩm và kinh doanh, chỉ số độ tin cậy và bảo mật, và tác động của AI sinh tạo lên chỉ số kỹ thuật.
  • Hạ tầng kho phản chiếu từ dự án anh em software-engineering-guide: một spec/ điều khiển bởi đặc tả (index, structure, conventions, oxford spelling, roadmap), một bộ xác thực trong tests/validate.py, một bộ sinh điều hướng trong tools/gen_nav.py, một justfile, AGENTS.md cùng các hướng dẫn đóng góp dưới docs/contributing/, CONTRIBUTING.md, và nhật ký thay đổi này.
  • spec/structure.md, bản kê chủ đề chuẩn mà các kiểm thử dùng để đối chiếu các tệp.
  • Hai ví dụ hoàn chỉnh trong docs/examples/: một hiến chương chỉ số đã điền sẵn và một đặc tả bảng điều khiển.

Lịch sử

Cuốn sách được xây dựng từ đặc tả đi ra: cấu trúc chín phần được khai báo trước trong spec/structure.md, rồi mỗi chủ đề được viết theo mẫu chung trong docs/contributing/chapter-template.md, với tests/validate.py thực thi cấu trúc và văn phong nội bộ xuyên suốt.

Quy ước cho tệp này

  • Nhóm các thay đổi dưới Added, Changed, Fixed, Removed hoặc Deprecated.
  • Giữ các mục ngắn và cụ thể. Mỗi mục một dòng nếu có thể.
  • Cũng không dùng dấu gạch ngang dài ở đây; các kiểm thử kiểm tra cả tệp này.