How much detail should a review version have?

One pesky problem that seems to pop up when I write or review papers is the “minor algebra error due to space constraints.” You have some theorem and then you go back and redefine x to be 2 y instead of y/2 and then suddenly stuff is off by a factor of 4 everywhere, but that doesn’t matter for the result per se — it’s just some constant floating around. This is of course an issue with conference papers, since they have strict page limits, and you end up shortening proofs to sketches, but it also happens while revising journal papers. One of the jobs of the reviewer is to check that the algebra works out, which becomes tedious if all the algebra is in fact correct but the paper skips 5 lines of simplifications and you have to go and work it out yourself.

Which brings me to the modest proposal : when submitting a journal paper, put in all the algebra, with a little footnote saying that you’ll omit the intermediate steps in the final version. This way, the checking for correctness becomes almost mechanical. Sure, it may make the submitted manuscript look bloated, but then the time saved can be spent on checking the structure of the argument. As an added benefit, the writer will be forced to explore the full ramifications of changing the notation around. Of course, this wouldn’t be possible (probably) for conference papers, but would it help for the journal process?


0 thoughts on “How much detail should a review version have?

  1. Why omit the algebra from the final version? Readers are perfectly capable of skipping algebra if it’s clear it’s routine; journals don’t have very strict page limits, especially these days.

  2. One issue is that the Transactions on Information Theory have imposed a page limit for correspondence items, and the Transactions on Signal Processing have page charges for papers over 8 pages, so this suggestion is limited to a “minor fix to the status quo.” I wouldn’t mind more detail in published papers, or even a “summary” with a link to the “full gory detail” version.

  3. With arXiv, it makes sense to have a link to a version with full, long, step-by-step proofs.

    I think the present level of detail in journal proofs is fine for most readers since they probably will only read the abstract/intro/result/conclusion anyway.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.