docs: update release notes and feature pages for Codex Translation Editor 0.31.0 and 0.32.0

content/docs/project-management/importing-files.mdx

@@ -88,6 +88,10 @@ Target imports may use different matching strategies depending on the file type:
 
 Always review imported target content before continuing translation work.
 
+## Re-import an Updated File
+
+If you import a Word document that matches one already in the project, Codex offers **Update Existing** instead of creating a duplicate pair. The source is rebuilt from the fresh file and existing translations are carried over. Use this when the original document was revised, or when a newer Codex release fixes an import problem in a file you imported earlier.
+
 ## Round-trip Workflows
 
 Round-trip importers keep enough original structure to export back to the original format. Common examples include DOCX, IDML, USFM, Markdown, OBS, TMS files, CSV/TSV, and Biblica workflows.

content/docs/project-management/source-and-target-languages.mdx

@@ -24,7 +24,16 @@ The **Create New Project** flow asks for source and target languages before the
 2. Find the project details near the top.
 3. Click the **Source** or **Target** language field.
 4. Choose the correct language, or create a custom language if needed.
-5. Sync shared projects after changing language metadata.
+5. Review the AI translation instructions when Codex asks (see below).
+6. Sync shared projects after changing language metadata.
+
+## Review AI Instructions After a Language Change
+
+When you change the source or target language to a different language, Codex opens a **Review AI Translation Instructions** window, because instructions written for the old language pair almost always need updating:
+
+- **Regenerate** creates fresh instructions for the new language pair. You can edit the result before saving.
+- **Save** stores the instructions shown in the text box.
+- **Cancel** (or closing the window) leaves your instructions untouched and shows a reminder pointing to where you can update them later.
 
 <Callout type="warning">
 Changing language settings after translation work has started can affect AI behavior and export metadata. Tell collaborators before changing languages in a shared project.

content/docs/releases/latest.mdx

@@ -11,45 +11,58 @@ This page summarizes user-facing changes that matter when following the document
 
 | Component | Latest stable release reflected here |
 | --- | --- |
-| **Codex Translation Editor extension** | `0.30.0` |
+| **Codex Translation Editor extension** | `0.32.0` |
 | **Codex desktop app** | `1.108.13184` |
 
 <Callout type="info">
 If your installed version is older, update Codex before troubleshooting behavior that differs from these docs.
 </Callout>
 
-## Codex Translation Editor 0.30.0
+## Codex Translation Editor 0.32.0
 
-Published July 13, 2026.
+Published August 19, 2026.
 
 ### New Features
 
-- **Audio track selector** in the video player: when a streamed video offers more than one language track, pick which audio track plays. See [Video and Audio Translation](/docs/translation/video-audio-translation).
-- **Advanced speech recognition (ASR)**: transcription now includes language auto-detection, a new **Re-transcribe** option, and updated settings.
+- **Built-in audio editor**: trim and edit recordings without altering the original, and preview your changes before saving. Recordings are automatically converted to a compact format on save. Audio attachments now share a 50 MB size limit. See [Video and Audio Translation](/docs/translation/video-audio-translation).
+- **Milestone editing**: milestones and subdivisions can now be renamed, promoted, and demoted directly from the navigation panel, and these changes are preserved across syncs. See [Milestones and Navigation](/docs/translation/milestones-and-navigation).
+- **Hide cells that shouldn't be translated**: project admins can now hide cells that shouldn't be translated. Hidden cells are excluded from exports, and the change is tracked in edit history. See [Merging and Editing Source Cells](/docs/translation/merging-editing-source-cells).
+- **Recording overage display**: when an audio recording runs past the allowed time, the recorder now shows how far over you are.
+- **AI system message review on language change**: changing your project's source or target language now prompts you to review and update the AI system message, so translation suggestions always match your current languages. Regeneration shows progress while it runs. See [Source and Target Languages](/docs/project-management/source-and-target-languages).
 
 ### Improvements
 
-- **Faster project opening**: smarter media handling skips unnecessary downloads and saves bandwidth, especially for **Stream Only** projects.
-- **Better Word (.docx) import**: an option splits long passages into properly sized cells instead of one large block.
-- **HTML formatting in AI edits**: when HTML Enforcement is turned on, AI suggestions from the sparkle button keep valid formatting, and a new **Resolve All** action fixes flagged formatting mismatches in bulk.
-- **Tidier exports**: exporting files that have no audio no longer creates empty folders, and exported file names now include verse ranges.
+- Export structure warnings now include a **Continue anyway** button, so a lingering mismatch no longer blocks the export flow.
+- The edit history view is now wider, making better use of the available space.
 
 ### Fixes
 
-- The **Publish to Cloud** button no longer covers text in narrow columns.
-- The audio status shown in the cell list is accurate again.
-- **Consolidate by Character** audio export now works in **Stream & Save** and **Stream Only** modes.
-- Deleting a video now stops it from continuing to load in streaming modes.
-- In the Export wizard, clicking a cell that has no audio now opens the correct chapter.
-- The **Unmerge** option for merged content was restored, and merging in the editor now asks for confirmation. See [Merging and Editing Source Cells](/docs/translation/merging-editing-source-cells).
-- Fixed several project-content issues: duplicate or repeated cells, mismatched verse ranges between source and target, source/target timestamp mismatches, deleted lines appearing in USFM export, and lingering Greek/Hebrew corpus marker titles after an overwrite.
-- Book names containing a period no longer lose the text after it when syncing.
+- **Sync data protection**: fixed an issue where syncing could save a translation file back as empty, wiping its contents. Sync now prevents these wipes and automatically restores any emptied files it finds. Also fixed a bug where one user's out-of-date working copy could unintentionally delete files for everyone else during sync, and other cases where files disappeared after sync merges.
+- Verse ranges (e.g. `1-3`) are no longer dropped when exporting to HTML or USFM.
+- USFM export no longer drops Paratext chapter headings.
+- Cells split with "ideal cell length" during Word document import now export correctly, even when some segments are still untranslated.
+- Re-importing a Word document into an existing project now merges properly instead of duplicating content, with clearer prompts during import.
+- Fixed stray text in BSB imports and added support for additional Biblica content that previously wasn't imported.
+- Fixed duplicate imports caused by double-clicking during eBible downloads or the Finish Import step. Imports now complete immediately and can't be submitted twice.
+- HTML tag mismatches can now be resolved properly, with a new structure repair option, improved tag handling, and a batch-resolve button that only appears when mismatches actually exist.
+- Fixed false "missing tag" warnings: merging two untranslated cells no longer triggers a structure mismatch, and editor-only formatting from imported InDesign documents is now ignored when comparing structure. Real mismatches are still caught, and repeated tags are now summarized instead of listed one by one.
+- Merging several source cells in a row now updates the open target file after every merge, instead of only the first one until a reload.
+- The editor now stays on the verse you were viewing after merges, unmerges, milestone edits, and toggling source editing mode, instead of jumping to the top of the chapter.
+- Pressing Escape in the edit history view now closes just that view instead of the whole cell editor.
 
 ### Versions and Requirements
 
-- The extension package now targets the `0.30.0` release and raises the required Frontier Authentication version to `0.9.0`. Pinned team projects receive compatible versions automatically.
+- The extension package now targets the `0.32.0` release. Pinned team projects receive compatible versions automatically.
 
-Full changelog: [codex-editor 0.30.0](https://github.com/genesis-ai-dev/codex-editor/releases/tag/0.30.0).
+Full changelog: [codex-editor 0.32.0](https://github.com/genesis-ai-dev/codex-editor/releases/tag/0.32.0).
+
+## Codex Translation Editor 0.31.0
+
+Published July 16, 2026.
+
+- **Cell Label Importer**: dialogue lists that use SMPTE timecode columns (`TC In` / `TC Out`) now import without spreadsheet preprocessing, and characters speaking at the same timestamp each keep their own label instead of overwriting one another. Rows that cannot be matched show as unmatched in the review table rather than replacing an earlier label.
+
+Full changelog: [codex-editor 0.31.0](https://github.com/genesis-ai-dev/codex-editor/releases/tag/0.31.0).
 
 ## Codex Desktop App 1.108.13184
 
@@ -62,6 +75,9 @@ Full changelog and downloads: [codex 1.108.13184](https://github.com/genesis-ai-
 
 ## Recent Features To Know
 
+- A built-in audio editor can trim, splice, and re-save cell recordings without external tools.
+- Milestones and subdivisions can be renamed, and milestone placement can be edited when the setting is turned on.
+- Project admins can hide cells that do not need translation; hidden cells skip AI translation and exports.
 - Media-heavy projects can choose **Auto Download Media**, **Stream & Save**, or **Stream Only**.
 - The video player can switch between audio language tracks when the video provides them.
 - Speech recognition supports language auto-detection and re-transcribing existing recordings.

content/docs/translation/exporting-project.mdx

@@ -40,6 +40,8 @@ The wizard changes based on the selected files and format, but the usual flow is
 | **Generate USFM Without Validation** | Faster scripture export when you intentionally need to bypass validation. |
 | **XLIFF** | Localization and CAT-tool workflows. |
 
+USFM export offers **Export paratext cells as section headings (\s1)**, which writes unformatted heading cells as USFM section headings instead of plain paragraphs. It is off by default. Cells that span several verses export their full verse range, such as `\v 1-3`.
+
 ## Round-trip Export
 
 Use **Round-trip Export** when the file was imported with a round-trip importer and you want to return to the original format.

content/docs/translation/merging-editing-source-cells.mdx

@@ -20,6 +20,7 @@ Use source editing when you need to:
 - Remove duplicated machine-generated content.
 - Add missing source text that was omitted during import.
 - Improve line breaks before translation begins.
+- Hide cells that do not need to be translated.
 
 Do not use source editing for translator discussion. Use [Comments](/docs/translation/comments) for questions and review notes.
 
@@ -64,6 +65,22 @@ If a merge was not right, you can undo it:
 
 Common corrections include punctuation, repeated words, missing phrases, and line breaks.
 
+## Hide Cells That Do Not Need Translation
+
+Imported files sometimes contain cells nobody should translate, such as boilerplate or repeated front matter. In source editing mode, each cell has an eye button next to the merge button:
+
+1. Enable source editing mode.
+2. Click the **eye** button on the cell you want to hide.
+3. The matching cell in the paired source or target file is hidden too.
+
+Hidden cells are not deleted. They stay in the file, appear dimmed in source editing mode so you can find and un-hide them, and sync to teammates like any other change. While hidden, they:
+
+- Do not appear in normal editing mode.
+- Are skipped by AI translation and autocomplete.
+- Are left out of exports. Round-trip exports keep the original untouched text in their place.
+
+To show a cell again, click its eye button in source editing mode.
+
 ## Disable Source Editing Mode
 
 When you are finished:

content/docs/translation/milestones-and-navigation.mdx

@@ -21,9 +21,25 @@ Milestones help Codex:
 
 Use the chapter or section controls at the top of the translation editor to move through milestones. The Navigation panel also shows imported files and progress so you can jump between sources and target files.
 
-## Edit Milestone Labels
+## Edit Milestones
 
-Some projects allow milestone names or labels to be edited inline. Use this carefully in shared projects because milestone changes can affect navigation, comments, export selection, and teammate expectations.
+The milestone accordion includes an edit (gear) toggle that reveals editing controls:
+
+- **Rename**: click the pencil next to a milestone or subdivision to rename it inline. Renaming is always available.
+- **Change placement**: with **Enable Milestone Placement Editing** turned on in Interface Settings, the gear also reveals controls to add and remove milestones and to promote a subdivision to a milestone or demote a milestone to a subdivision.
+
+Structural changes are made on source documents. Target documents show only the rename controls.
+
+Use milestone editing carefully in shared projects because milestone changes can affect navigation, comments, export selection, and teammate expectations.
+
+## Pagination and Subdivisions
+
+Interface Settings has a "Pagination & Subdivisions" section that controls how milestones split into pages:
+
+- **Cells per page** sets how many cells load per subdivision page.
+- **Maximum subdivision length** optionally sub-chunks long stretches between custom breaks.
+
+Changes apply to open editors without a reload.
 
 ## Milestones and Export
 

content/docs/translation/video-audio-translation.mdx

@@ -27,17 +27,31 @@ Cell audio tools can include:
 
 - Play audio.
 - Record target audio.
-- Rerecord or remove audio.
+- Rerecord, edit, or remove audio.
 - Transcribe speech to text, with automatic language detection.
 - **Re-transcribe** an existing recording after changing transcription settings.
 - Copy timestamps from the matching source cell when source and target timing drift apart.
 - Validate audio.
 - Use a countdown before recording starts.
 
+If a recording runs past the cell's allotted time, the Audio Recording and Timestamps tabs show the extra time in brackets next to the allowed length, such as `30.0s [+5.000s]`. Recordings at or under the allowed time show no brackets.
+
 <Callout type="info">
 If Codex does not detect a microphone, the record button is disabled and a warning explains why. Check your input device and system permissions, then reopen the cell.
 </Callout>
 
+## Edit Recorded Audio
+
+The cell editor includes a built-in audio editor for cleaning up recordings without leaving Codex or installing FFmpeg:
+
+- Select a range on the waveform, then **delete** it or **keep** only that range.
+- **Insert** another audio file at a chosen point on the timeline.
+- Drag the Start, End, and Insert pointers directly on the waveform, or adjust them in 0.01-second steps.
+- Zoom the waveform with Ctrl + mouse wheel.
+- Undo delete, keep, and insert operations.
+
+Edits are non-destructive. The original recording is preserved, and saving writes the edited audio as a new version, automatically converted to a compact format. Audio attachments share a 50 MB size limit.
+
 ## Video Audio Tracks
 
 When a streamed video provides more than one audio language track, the video player shows an audio track selector. Use it to pick which language plays while you translate. The selector only appears when the video actually offers multiple tracks.