Apply a source revision and re-check the same question

What this is for

Replace a source with its real revision, review what changed, and ask the same question again to see which parts of the answer moved and which did not.

Before you start

Sources: PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP, JPG, PNG, TIF or GIF. Every one of them is sanitized to PDF and read by OCR before anything else happens.

Tables and formulas are not extracted as tables: a figure arrives as the paragraph it was printed in, with the page and the box it sat in, so a number is readable and the grid that arranged it is not. Heading levels, sections and columns are not recovered as typed structure; what the compiler receives is a paragraph and where it sat. TAVONEL processes sources up to 5 MB and 80 pages.

A compile produces a candidate, and a candidate becomes an active World only when a person activates it in the workspace. That step needs a paid plan: the Developer plan, if you are the workspace owner, or the Team plan, which is sold through a conversation today rather than self-serve checkout. A free evaluation can upload, compile, review and export; its activation request is refused, so decide the plan before you plan the run.

Write down what you expect to change, what you expect to disappear and what you expect to stay the same before the run, or the comparison afterwards proves nothing. Adding a new quarterly report is corpus growth, not a revision of the same source, and the two are not mixed.

What a free evaluation includes, and what a page costs, are on the pricing page. This page does not restate either, so it cannot disagree with them.

Running it in code

The review section carries the candidate queue and the decision records a revision produces; the run-events section carries the state a client polls while it happens.

The exact contract: Review in the documentation.

Where this stops

A revision produces a new candidate that a person reviews and activates, so nothing changes for a reader until that happens. A rollback is its own action against current sources and access rules: it does not reach back into work an external consumer already produced from an older answer.

The reading limits under "Before you start" apply to this recipe too.

Next action

Read the review section for how a candidate is decided, and bring a real revision rather than an edited copy when you try this on your own documents.

Run and revision information

Every section above describes what the product does today, and the revision of this guide is printed at the foot of the page. A verified run date appears there only once a person has recorded a run, never on an edit to this page.

What a recorded run will add

The actual input — The document set the run used, published from a corpus cleared for redistribution.

Following it on screen — A capture of the workspace screens as the run passed through them, recorded rather than staged.

What the run produced — The files, tables and drafts the run produced, as it produced them.

Checking it against the source — The source location behind each value, opened at the page and the region it came from.

Using the result outside TAVONEL — The result an external consumer read back from the same World, verified on its own run.

Measured effect — Quality, time, cost and human effort, from a same-condition measurement of that run.