Skip to content

URUCON paper: make DOCX the sole authoritative manuscript#38

Merged
krahd merged 31 commits into
mainfrom
agent/urucon-docx-authoritative
Jul 22, 2026
Merged

URUCON paper: make DOCX the sole authoritative manuscript#38
krahd merged 31 commits into
mainfrom
agent/urucon-docx-authoritative

Conversation

@krahd

@krahd krahd commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Purpose

Migrate the URUCON 2026 paper from a LaTeX-led pipeline to a single authoritative Microsoft Word manuscript using the supplied IEEE A4 template.

Changes

  • rebuilds the revised paper directly in the IEEE A4 Word template;
  • adds the untouched conference-template-a4.docx to the paper directory;
  • makes BatLLM_URUCON_2026_Paper.docx the sole editable and submission manuscript;
  • removes the LaTeX source, bibliography, generated result macros, build log, conversion script, generated PDFs, and duplicate main.docx;
  • removes automatic LaTeX result rendering from the experiment pipeline;
  • updates documentation and artefact packaging around the Word-first workflow;
  • changes CI to validate the DOCX structurally and render it temporarily for A4 geometry and page-count checks;
  • regenerates checksums and the complete research artefact package.

Validation

  • native DOCX structures and IEEE styles retained;
  • three A4 pages;
  • all three rendered pages visually inspected;
  • equations, tables, citations, section numbering, title block, and two-column layout verified;
  • DOCX ZIP integrity and British-English metadata verified;
  • temporary validation PDF is not committed.

A one-time workflow decodes the staged Word binaries and removes its staging files before this PR is merged.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c3f79455c3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +23 to +24
cat .docx-payload/paper-* | base64 -d > research/urucon2026/paper/BatLLM_URUCON_2026_Paper.docx
cat .docx-payload/template-* | base64 -d > research/urucon2026/paper/conference-template-a4.docx

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Regenerate the staged DOCX payloads

When these commands concatenate and decode the added .docx-payload chunks, the resulting files are not valid DOCX ZIPs: unzip -t reports invalid compressed data for the paper and a truncated/overlapped template. That means the archive.testzip() validation in the next step fails and the one-time migration never commits the real Word files, so the staged payloads need to be regenerated from valid DOCX files.

Useful? React with 👍 / 👎.

Comment on lines +123 to +125
template="research/urucon2026/paper/conference-template-a4.docx"
test -s "$paper"
test -s "$template"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Commit the template before requiring it in CI

At this commit, research/urucon2026/paper/conference-template-a4.docx is not present in the tree; only the staging chunks under .docx-payload/ exist. This new test -s "$template" check therefore fails in the research-artifact job before packaging can run on any PR or push at this revision, so the DOCX should be committed before CI requires it or CI should keep using an existing path until the migration has landed.

Useful? React with 👍 / 👎.

@@ -0,0 +1,10 @@
# DOCX manuscript migration

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update STATUS.md for the migration

This commit changes the URUCON workflow, artefact packaging, paper-source layout, and documentation, but leaves STATUS.md unchanged; the project status report is stale for the new Word-first workflow and validation state, which the repository instructions treat as mandatory upkeep for project changes.

Useful? React with 👍 / 👎.

@krahd
krahd merged commit 9e40f65 into main Jul 22, 2026
16 of 17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant