Browse the documentation
AI-Soda Brain

Create charts and reports readers can verify

Preserve the question, sources and metric definitions so readers can trace a conclusion to its evidence. Charts, separate report sections and the final file each have their own completion criteria.

Technical guide · November 20263 min read

Define the report task

Identify the audience, reporting period, main question and required format. Organize an operating report around a few key metrics, then explain changes and limitations for each one. A collection of every available figure can obscure the business question.

Before charting, confirm the data grain, units, denominator and treatment of missing values. A reader should be able to find the total in a bar chart, the time interval in a line chart and the denominator in a share chart in the text or a table.

Judge completion by the deliverable

Output stateAcceptance criteria
AnalysisConclusions can be matched to supporting sources.
Sample chartTitle, units, period and legend are present.
Separate report sectionsEach section is readable. Assembly and consistency still need checking.
Final fileThe whole file opens, and the contents, page count, references and version agree.

Review the complete output

  1. Check the task list for missing, truncated or duplicated sections.
  2. Reconcile selected key metrics with the baseline report and confirm that tables and prose use the same definitions.
  3. Check figures and citation locations. Identify recommendations that cannot be inferred directly from a chart.
  4. Open the final file on the target device. Check fonts, pagination, links and downloads.
  5. Confirm the intended recipients and remove unnecessary personal or internal records before sharing.

Report the actual state after an interruption

If only the analysis or some sections are available, retain them and specify what remains. A cover page or progress message is insufficient evidence of final delivery. Before retrying, check the snapshot, task scope and execution state to avoid mixing results from separate runs.

Supply a text conclusion or data table alongside charts so readers can understand the findings if an image fails to load, the screen is small or they use assistive reading technology.

Further reading

Try “permissions,” “data source,” “manufacturing” or “API.”