RecSys Writing Style
Use this when revising the main paper. RecSys papers need a compact statement of why a
recommendation result matters and enough evaluation detail to survive a reproducibility-minded
reviewer.
Revision rules
- Put the recommendation contribution on the first page: problem, gap, method, offline evidence,
and the offline-to-deployment bridge.
- Make the evaluation protocol explicit early: the split (temporal vs random), whether metrics are
full-ranking or sampled, and that baselines are tuned under an equal budget.
- Pair every empirical claim with a table, an ablation, or an off-policy/A-B result — not with a
superlative.
- Use the 8-page body for core logic; move tuning grids, extra datasets, and per-dataset
breakdowns to the appendix (which counts inside the budget) without making the body unreadable.
- Avoid leaderboard framing ("state of the art," "outperforms all baselines") when the gain is
small, the variance unreported, or the baselines under-tuned.
- Maintain double-blind style in self-citations, platform names, acknowledgements, funding, and
the repository description.
Claim-discipline for recommender papers
- State the split protocol in words, not just in a config: "we use a temporal leave-one-last
split" pre-empts the leakage objection.
- Say the baselines were tuned with the same budget as the method; this one sentence defuses
the field's central reproducibility complaint.
- When an offline metric is the only evidence, scope the claim to offline; do not let "nDCG rose"
masquerade as "users are better served."
- Report variance (mean ± sd over seeds), and in captions say whether bars are sd, confidence
intervals, or quantiles.
- Label beyond-accuracy goals (diversity, fairness, exposure) as measured quantities, not
asserted virtues.
Sentence-level rewrites
| Draft pattern |
RecSys-safe rewrite |
| "Our model significantly outperforms all baselines." |
"improves nDCG@20 by X (sd Y) over equal-budget-tuned baselines" |
| "We evaluate on a standard split." |
"We use a temporal leave-one-last split to avoid future leakage." |
| "Achieves state-of-the-art recommendation." |
Claim scoped to the datasets and cutoff actually tested |
| "Users will benefit from better recommendations." |
"our off-policy estimate of engagement rises; deployment is future work" |
| "We use Recall@20." |
"Recall@20 over the full item catalog (not a sampled candidate set)" |
Vignette: compressing into eight two-column pages
A draft with a model, five datasets, and a sprawling related-work section: keep the method, the
assumption, the headline tuned table, one mechanism ablation, and the offline-online bridge in the
body; compress related work into contribution contrasts; move the tuning grid, two datasets, and
per-dataset breakdowns to the appendix with explicit forward references. The test of a good cut: a
reviewer should reconstruct the whole argument, including how the baselines were tuned, without
opening the repository.
Output format
[Writing diagnosis] clear / under-justified / overclaimed / leakage-ambiguous
[First-page fix] <new recommendation-first framing>
[Claim discipline] <claim -> table / ablation / off-policy result / scoped limitation>
[Evaluation wording] <split protocol / metric type / tuning-budget statement>
[Compression cuts] <move / delete / merge>
[Anonymity edits] <phrases to rewrite>
1---2name: recsys-writing-style3description: Use when revising an ACM RecSys paper for a recommendation-first first page, honest offline-versus-online framing, equal-budget baseline claims, leakage-aware evaluation wording, ACM two-column 8-page compression, double-blind phrasing, and claims scoped to what the ranking evidence actually supports rather than to leaderboard language.4metadata:5 source: https://skillmd.com/skills/brycewang-stanford/recsys-writing-style6---78# RecSys Writing Style910Use this when revising the main paper. RecSys papers need a compact statement of why a11**recommendation** result matters and enough evaluation detail to survive a reproducibility-minded12reviewer.1314## Revision rules1516- Put the recommendation contribution on the first page: problem, gap, method, offline evidence,17 and the offline-to-deployment bridge.18- Make the evaluation protocol explicit early: the split (temporal vs random), whether metrics are19 full-ranking or sampled, and that baselines are tuned under an equal budget.20- Pair every empirical claim with a table, an ablation, or an off-policy/A-B result — not with a21 superlative.22- Use the 8-page body for core logic; move tuning grids, extra datasets, and per-dataset23 breakdowns to the appendix (which counts inside the budget) without making the body unreadable.24- Avoid leaderboard framing ("state of the art," "outperforms all baselines") when the gain is25 small, the variance unreported, or the baselines under-tuned.26- Maintain double-blind style in self-citations, platform names, acknowledgements, funding, and27 the repository description.2829## Claim-discipline for recommender papers3031- State the split protocol in words, not just in a config: "we use a temporal leave-one-last32 split" pre-empts the leakage objection.33- Say the baselines were tuned with the **same budget** as the method; this one sentence defuses34 the field's central reproducibility complaint.35- When an offline metric is the only evidence, scope the claim to offline; do not let "nDCG rose"36 masquerade as "users are better served."37- Report variance (mean ± sd over seeds), and in captions say whether bars are sd, confidence38 intervals, or quantiles.39- Label beyond-accuracy goals (diversity, fairness, exposure) as measured quantities, not40 asserted virtues.4142## Sentence-level rewrites4344| Draft pattern | RecSys-safe rewrite |45|---|---|46| "Our model significantly outperforms all baselines." | "improves nDCG@20 by X (sd Y) over equal-budget-tuned baselines" |47| "We evaluate on a standard split." | "We use a temporal leave-one-last split to avoid future leakage." |48| "Achieves state-of-the-art recommendation." | Claim scoped to the datasets and cutoff actually tested |49| "Users will benefit from better recommendations." | "our off-policy estimate of engagement rises; deployment is future work" |50| "We use Recall@20." | "Recall@20 over the full item catalog (not a sampled candidate set)" |5152## Vignette: compressing into eight two-column pages5354A draft with a model, five datasets, and a sprawling related-work section: keep the method, the55assumption, the headline tuned table, one mechanism ablation, and the offline-online bridge in the56body; compress related work into contribution contrasts; move the tuning grid, two datasets, and57per-dataset breakdowns to the appendix with explicit forward references. The test of a good cut: a58reviewer should reconstruct the whole argument, including *how the baselines were tuned*, without59opening the repository.6061## Output format6263```text64[Writing diagnosis] clear / under-justified / overclaimed / leakage-ambiguous65[First-page fix] <new recommendation-first framing>66[Claim discipline] <claim -> table / ablation / off-policy result / scoped limitation>67[Evaluation wording] <split protocol / metric type / tuning-budget statement>68[Compression cuts] <move / delete / merge>69[Anonymity edits] <phrases to rewrite>70```