[PR #2732] [MERGED] docs(website): publish essay on reverse engineering models #5350

New issue

Closed

opened 2026-10-31 01:05:56 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-31 01:05:56 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/2732
Author: @N0zoM1z0
Created: 10/13/2026
Status: ✅ Merged
Merged: 10/13/2026
Merged by: @N0zoM1z0

Base: main ← Head: docs/blog-re-models

📝 Commits (7)

cfeed04 docs(website): add essay on reverse engineering models
37adcdf fix(website): keep omitted language selectors free of whitespace
6372ba4 docs(website): improve model essay transitions and narrative flow
94b1fe6 docs(website): use straight quotes in model essay
eee122b docs(website): simplify reconstruction evidence in model essay
778d32a docs(website): publish model essay in all supported languages
2b34f67 fix(website): clarify translated evidence and runtime observations

📊 Changes

25 files changed (+26481 additions, -212 deletions)

View changed files

📝 scripts/website.py (+1 -1)
📝 website/README.md (+1 -0)
➕ website/evidence/reverse-engineering-models.md (+166 -0)
📝 website/locales/ar/messages.po (+1339 -11)
📝 website/locales/de/messages.po (+1433 -11)
📝 website/locales/es/messages.po (+1421 -11)
📝 website/locales/fa/messages.po (+1353 -11)
📝 website/locales/fr/messages.po (+1438 -11)
📝 website/locales/id/messages.po (+1412 -11)
📝 website/locales/it/messages.po (+1421 -11)
📝 website/locales/ja/messages.po (+1192 -11)
📝 website/locales/ko/messages.po (+1243 -11)
📝 website/locales/messages.pot (+1046 -12)
📝 website/locales/pl/messages.po (+1405 -11)
📝 website/locales/pt-BR/messages.po (+1407 -11)
📝 website/locales/ru/messages.po (+1406 -11)
📝 website/locales/th/messages.po (+0 -0)
📝 website/locales/tr/messages.po (+0 -0)
📝 website/locales/uk/messages.po (+0 -0)
📝 website/locales/vi/messages.po (+0 -0)

...and 5 more files

📄 Description

Summary

Publish “Does reverse engineering need a bigger model?” in the Blog, with complete translations in every supported website language. The essay uses Touhou reconstruction history to explore general models, compiler specialization, repository knowledge and reinforcement learning.

Problem and expected behavior

Readers can follow the argument from concrete discoveries to a proposed comparison, inspect the supporting commits and research, and switch among all 19 language editions. The article is linked from the Blog index and included in the generated sitemap.

Change and scope

Add the English essay and its pinned evidence record. Keep detailed byte counts in the supporting document; explain the cases in plain language in the article.
Translate and edit all 18 non-English editions through the existing gettext catalogs. Preserve executable literals, model names and evidence links.
Remove draft/noindex labels, synchronize shared markup and document the new page.
Put optional language-picker indentation in the rendering owner so omitted draft selectors do not leave whitespace-only lines.

This is website documentation within the existing contribution scope. A provider scope decision is not applicable. Preserve the checkpoint commits when merging; use rebase rather than squash.

Contract and boundary impact

Semantic owner: English website source and gettext catalogs; shared-header renderer for the indentation fix.
CLI, MCP, provider, authority, cleanup, package and installation contracts: unchanged.
Evidence: historical function-level comparisons and operator-supplied model attribution; specialist/RL comparisons remain proposed experiments.
Generated outputs: language HTML, sitemap, ZIP and sharing image remain ignored build artifacts.

Expected effects:

Documentation or usability only; no target interaction.

Evidence and regression coverage

The article links immutable reconstruction commits and primary research. Existing website maintenance checks cover extraction, shared markup, translated routes, fallback handling and publishing ownership. Browser checks cover the article and its index entry in every edition.

Validation performed

python scripts/website.py translations check --strict — all 1,594 messages translated in all 18 catalogs; no missing or fuzzy entries.
python scripts/website.py check — 12 maintenance tests passed; 344 HTML pages and 22,009 local references verified, including 342 indexable reading pages.
Chromium — 44 cases across 19 languages, root and /rea/ paths, 320px mobile layouts, expanded sources, language links, light/dark switching and no-JavaScript reading.
Formatting and git diff --check passed. Existing translations outside the Blog scope were preserved.

Compatibility, safety, and release

Publication uses the existing manual website-pages.yml workflow with target=both. Cloudflare and GitHub Pages receive the same verified artifact. Public sources contain no local machine paths or private captures.

Before merge

Agreed article publication; no separate issue is needed.
Scope and authority are resolved.
Final diff is focused and preserves evidence scope.
Website documentation and translation catalogs are updated.
Relevant checks pass; deployment follows merge.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/2732 **Author:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Created:** 10/13/2026 **Status:** ✅ Merged **Merged:** 10/13/2026 **Merged by:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Base:** `main` ← **Head:** `docs/blog-re-models` --- ### 📝 Commits (7) - [`cfeed04`](https://github.com/morluto/rea/commit/cfeed04db0910010a316734234807864cbc24477) docs(website): add essay on reverse engineering models - [`37adcdf`](https://github.com/morluto/rea/commit/37adcdfc2346911737852a7d93ac77f6cc592e7a) fix(website): keep omitted language selectors free of whitespace - [`6372ba4`](https://github.com/morluto/rea/commit/6372ba41ede9a64c70259231fc5d065c98197c1f) docs(website): improve model essay transitions and narrative flow - [`94b1fe6`](https://github.com/morluto/rea/commit/94b1fe6e83a5b79497dfb83758736483c33cf81b) docs(website): use straight quotes in model essay - [`eee122b`](https://github.com/morluto/rea/commit/eee122bb1016049797a653c17b9f6501b33bd2e3) docs(website): simplify reconstruction evidence in model essay - [`778d32a`](https://github.com/morluto/rea/commit/778d32a66c288f12c4a6b992c63381f58f59ae85) docs(website): publish model essay in all supported languages - [`2b34f67`](https://github.com/morluto/rea/commit/2b34f678e8a0625330ba65c8eabce1089107b542) fix(website): clarify translated evidence and runtime observations ### 📊 Changes **25 files changed** (+26481 additions, -212 deletions) <details> <summary>View changed files</summary> 📝 `scripts/website.py` (+1 -1) 📝 `website/README.md` (+1 -0) ➕ `website/evidence/reverse-engineering-models.md` (+166 -0) 📝 `website/locales/ar/messages.po` (+1339 -11) 📝 `website/locales/de/messages.po` (+1433 -11) 📝 `website/locales/es/messages.po` (+1421 -11) 📝 `website/locales/fa/messages.po` (+1353 -11) 📝 `website/locales/fr/messages.po` (+1438 -11) 📝 `website/locales/id/messages.po` (+1412 -11) 📝 `website/locales/it/messages.po` (+1421 -11) 📝 `website/locales/ja/messages.po` (+1192 -11) 📝 `website/locales/ko/messages.po` (+1243 -11) 📝 `website/locales/messages.pot` (+1046 -12) 📝 `website/locales/pl/messages.po` (+1405 -11) 📝 `website/locales/pt-BR/messages.po` (+1407 -11) 📝 `website/locales/ru/messages.po` (+1406 -11) 📝 `website/locales/th/messages.po` (+0 -0) 📝 `website/locales/tr/messages.po` (+0 -0) 📝 `website/locales/uk/messages.po` (+0 -0) 📝 `website/locales/vi/messages.po` (+0 -0) _...and 5 more files_ </details> ### 📄 Description ## Summary Publish “Does reverse engineering need a bigger model?” in the Blog, with complete translations in every supported website language. The essay uses Touhou reconstruction history to explore general models, compiler specialization, repository knowledge and reinforcement learning. ## Problem and expected behavior Readers can follow the argument from concrete discoveries to a proposed comparison, inspect the supporting commits and research, and switch among all 19 language editions. The article is linked from the Blog index and included in the generated sitemap. ## Change and scope - Add the English essay and its pinned evidence record. Keep detailed byte counts in the supporting document; explain the cases in plain language in the article. - Translate and edit all 18 non-English editions through the existing gettext catalogs. Preserve executable literals, model names and evidence links. - Remove draft/noindex labels, synchronize shared markup and document the new page. - Put optional language-picker indentation in the rendering owner so omitted draft selectors do not leave whitespace-only lines. This is website documentation within the existing contribution scope. A provider scope decision is not applicable. Preserve the checkpoint commits when merging; use rebase rather than squash. ## Contract and boundary impact - Semantic owner: English website source and gettext catalogs; shared-header renderer for the indentation fix. - CLI, MCP, provider, authority, cleanup, package and installation contracts: unchanged. - Evidence: historical function-level comparisons and operator-supplied model attribution; specialist/RL comparisons remain proposed experiments. - Generated outputs: language HTML, sitemap, ZIP and sharing image remain ignored build artifacts. Expected effects: - [x] Documentation or usability only; no target interaction. ## Evidence and regression coverage The article links immutable reconstruction commits and primary research. Existing website maintenance checks cover extraction, shared markup, translated routes, fallback handling and publishing ownership. Browser checks cover the article and its index entry in every edition. ## Validation performed - `python scripts/website.py translations check --strict` — all 1,594 messages translated in all 18 catalogs; no missing or fuzzy entries. - `python scripts/website.py check` — 12 maintenance tests passed; 344 HTML pages and 22,009 local references verified, including 342 indexable reading pages. - Chromium — 44 cases across 19 languages, root and `/rea/` paths, 320px mobile layouts, expanded sources, language links, light/dark switching and no-JavaScript reading. - Formatting and `git diff --check` passed. Existing translations outside the Blog scope were preserved. ## Compatibility, safety, and release Publication uses the existing manual `website-pages.yml` workflow with `target=both`. Cloudflare and GitHub Pages receive the same verified artifact. Public sources contain no local machine paths or private captures. ## Before merge - [x] Agreed article publication; no separate issue is needed. - [x] Scope and authority are resolved. - [x] Final diff is focused and preserves evidence scope. - [x] Website documentation and translation catalogs are updated. - [x] Relevant checks pass; deployment follows merge. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-31 01:05:56 +00:00