| name | vis-writing-style |
| description | Use when revising an IEEE VIS paper for a task-grounded visualization contribution on the first page, a design rationale that ties each visual encoding and interaction to a task, evaluation matched to the contribution type, honest limitations, and disciplined use of the VGTC/TVCG 9+2 page budget for a paper that will be read as an IEEE TVCG journal article. |
VIS Writing Style
Use this when revising the main paper. IEEE VIS papers are IEEE TVCG journal articles read by
visualization researchers, so they need a task-grounded visualization contribution stated on the
first page and a design rationale a reviewer trusts. The failure this skill prevents is a
technically fine paper that reads like a gallery of pretty pictures, or an ML/systems result with a
chart bolted on, instead of a contribution about how people see and reason with data.
Revision rules
- Lead with the visualization contribution: the data-and-task problem, why existing
representations are inadequate for it, the contribution (technique, system, study, or model), the
evidence, and what changes for people analyzing data.
- Justify every encoding and interaction by task. Each visual channel (position, length, color,
shape) and each interaction (filter, brush, link) should be tied to the analysis task it serves —
not chosen by habit. An unjustified encoding is the fastest VIS reject.
- Match evaluation to the contribution type. A perceptual claim needs a controlled study; a
technique needs a benchmark or comparison; a design study needs reflection and validation across
abstraction levels; a system needs a demonstration of real use. Do not evaluate a system with an
accuracy number that answers a different question.
- Report limitations honestly. Name where the encoding breaks down (scale, occlusion, data
type), where the study's validity is bounded, and what you did not test — reviewers reward candor
and punish over-claiming.
- Respect the 9+2 page budget as a design constraint, not a formatting afterthought; a
figure-heavy field forces deliberate space choices.
- Maintain double-blind wording (if you opted in) in self-citations, system names,
acknowledgements, and open-materials links.
Visualization-paper skeleton
| Section | Job it must do | Common failure |
|---|
| Intro | Data/task problem, inadequacy, contribution, evidence preview, payoff — first page | Leads with a technology trend or a screenshot, not a task |
| Related work | Position against the nearest visualization prior work as a delta | Catalog of citations with no contrast |
| Data & task abstraction | What data, what tasks, at what abstraction level | Jumps to a design with no task grounding |
| Design / technique | The encoding + interaction, each justified by task | Design by aesthetics; unjustified channels |
| Evaluation | Evidence matched to the contribution type | Method mismatched to the claim (e.g., accuracy for a usability claim) |
| Limitations & discussion | Where it breaks; what generalizes | Generic paragraph untethered to this design |
Sentence-level rewrites
| Draft pattern | VIS-safe rewrite |
|---|
| "Our tool is intuitive and powerful." | "supports task T; in the study, users completed T faster (effect size ..., 95% CI ...) than with " |
| "We use color to show the values." | "we encode magnitude with a CVD-safe luminance ramp because the task is ordered comparison" |
| "The visualization looks clean." | Claim scoped to a task outcome or a measured perceptual property, not aesthetics |
| "We evaluate on a large dataset." | "we demonstrate on , chosen because it exhibits the technique targets" |
| "Users liked the system." | "in the study, N of P participants preferred it for task T; qualitative themes in §7" |
Design-rationale discipline
[Data] what is the data type (quantitative/ordinal/nominal/temporal/network/spatial)?
[Task] what analysis task (compare/locate/cluster/correlate/track-change)?
[Encoding] which channel serves that task, and why is it more effective than the obvious default?
[Interaction] which interaction reduces the cost of the task, and what does it cost the user?
-> state each choice next to the view it produces, not as a separate "we chose colors" aside
Vignette: rescuing a design-by-screenshots draft
A draft that opens with a system screenshot and lists features: rewrite the intro to lead with the
domain data and the analyst's task; add a data/task abstraction section; for each view, add one
sentence tying its encoding to a task; replace "users found it useful" with the study's measured
outcomes and qualitative themes; and add a limitations paragraph naming the scale at which the main
view degrades. The test of a good revision: a reviewer can answer "what task does each view serve,
and what is the evidence it serves it?" from the body alone.
Output format
[Writing diagnosis] clear / under-motivated / design-by-aesthetics / evaluation-mismatched / over-claimed
[First-page fix] <new framing leading with the data/task contribution>
[Encoding audit] <view -> channel -> task served -> justified? yes/no>
[Evaluation match] <contribution type -> evidence type -> present? yes/no>
[Anonymity edits] <system names / self-citations / links to rewrite (if double-blind)>
