Skip to content

chore: pin TechEngine ff4e11e and document the real repository layout - #394

Merged
Seungpyo1007 merged 8 commits into
developfrom
chore/structure-docs
Nov 11, 2026
Merged

Seungpyo1007 merged 8 commits into
developfrom
chore/structure-docs

Conversation

@TechEngineBot

Copy link
Copy Markdown
Member

What & why

Closes #297

The TechEngine pin moves to ff4e11e (TechEngine 134), where the engine no longer carries TechAPI as a submodule. The loop between the two repos is gone, so the comments and README notes that warned about recursive checkouts are corrected. The README now documents all thirteen data categories with their real path patterns and counts, a repository map and the related repositories, and data/README.md matches it.

Changes

  • Pin: TechEngine gitlink and the three uses: lines in collect.yml move to ff4e11ec294e2f7c428bcfc3a3298ce8163e7d6a.
  • Docs: README gains a repository map, a table of every category under data/ and a related-repositories section. data/README.md had three wrong path patterns (brand, soc, smartphone).
  • Templates: the data issue forms offer every category; bug_report.yml no longer asks for a request id; feature_request.yml stands on its own; the CODEOWNERS TODO is gone.
  • Validator: the game checks are removed from app/validate.py. Games live in game-catalog and data/game does not exist.
  • Line endings: .editorconfig and .gitattributes (* text=auto eol=lf) are added. app/validate.py was the only CRLF file in the repo and is now stored with LF; apart from line endings and the game checks its content is unchanged.

No file under data/ changes except data/README.md.

Source

Not a data change.

Checklist

  • The PR targets develop (main only moves through release PRs)
  • python -m app.validate passes locally
  • Sidebar filled in by hand: assignees, labels, milestone, projects, and the tracker under Development

This brings in GetTechAPI/TechEngine#134, the engine's own cleanup. The
engine no longer carries TechAPI as a submodule, so the two repos stop
pointing at each other. app/dump_check.py, app/verify/baseline.py and
passmark_ids.json are gone; nothing here called them. integrity_check.py
now reads the directory app.data_root resolves when no path is given,
instead of a Windows path that existed on one machine.

collect.yml's three `uses:` move to the same commit. In the reusable
workflows only a comment changed; the collectors, the validator and the
dump code are untouched.
Since the pin moved to ff4e11e, TechEngine carries no submodule, so a
recursive checkout has nothing to loop on. The comments in pages.yml,
pr-checks.yml, final-check.yml and build-api.sh, and two notes in the
README, still warned about it. The checkouts stay plain and
non-recursive; only the wording changes.
The Layout section listed five of the thirteen categories. It now has a
table with each category's real path pattern, file count and an example,
notes on the year, country, base-model and prefix folders, and what
data/_verify/ is. A short repository map names data/, app/, site/,
TechEngine/ and each workflow and script under .github/, and a new
section points at the related repositories.
brand/ has a country folder, and soc/ and smartphone/ have a year
folder; the file showed none of them and left out eight categories. It
now lists every category, explains _verify/, and points at the table in
the root README. The note about curation no longer says every record is
hand-verified: `verified` on the record says that.
- data_addition offered four categories; it and data_correction now
  offer all thirteen. data_correction asks for the category because a
  slug is unique only within one.
- bug_report asked for a request_id and showed api.techapi.dev. There
  is no live server: the example is now a static API URL and the field
  is gone.
- feature_request no longer cites a decision record and an app that
  nothing in this repo explains.
- The PR checklist drops a review step that is not used, and CODEOWNERS
  drops a finished TODO.
- config.yml sends engine and game issues to their own repositories.
  Blank issues stay enabled.
Games moved to the game-catalog repository and data/game no longer
exists, so GAME_REQUIRED and the loop over an always-empty list checked
nothing. The engine's validator has no game branch either.

The docstring named a validate-data.yml workflow this repo does not
have; it now names what runs the validator and says which document the
section numbers in the messages belong to. A comment cited a decision
record that is about something else. No check changes: the full scan
passes as before. Line endings are untouched (still CRLF).
.editorconfig is the same as TechEngine's: UTF-8, LF, final newline,
4 spaces for Python and 2 for YAML, JSON, Astro, Markdown and mjs.
.gitattributes sets `* text=auto eol=lf`, so a Windows checkout no
longer turns files into CRLF.

app/validate.py was the only tracked text file stored with CRLF (all of
data/ is LF already). It is renormalised here: every line shows as
changed, but `git diff --ignore-cr-at-eol` against the parent is empty.
The directory it named is local to one machine and is kept out through the clone's own exclude file instead.
@TechEngineBot TechEngineBot added documentation Improvements or additions to documentation enhancement New feature or request ci CI and workflow changes app Validator or application code changes labels Nov 11, 2026
@Seungpyo1007
Seungpyo1007 merged commit a463f92 into develop Nov 11, 2026
9 checks passed
@Seungpyo1007
Seungpyo1007 deleted the chore/structure-docs branch November 11, 2026 17:13
@github-project-automation github-project-automation Bot moved this from Todo to Done in TechAPI-Project Nov 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

app Validator or application code changes ci CI and workflow changes documentation Improvements or additions to documentation enhancement New feature or request

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

Engine, TechEngineBot and automation (workstream)

2 participants