4 ms·

I don't agree with the author. For me each of the sins have their goal that isn't in what they state. I wonder what the author thinks of this almost 25 years la

I don't agree with the author. For me each of the sins have their goal that isn't in what they state. I wonder what the author thinks of this almost 25 years later. ----- * The grandmothering: Too often have I read an abstract, not understood it (since an abstract is allowed to be dense), and quit on these first lines orienting the paper in the field . If it's your field these lines don't cost, if you're a newcomer, or from another field, you get the keywords you need to know before starting. And often you know this paper isn't what you were looking for. As for the near-meaninglessness of this sentence: look up the first sentence of any book. You can't put 100 pages in one sentence. * The table of contents: writers can't actually insert a table of contents, yet a paper needs it. True, nobody cares what's in Section 5, yet without this sentence you don't know when it will end, you don't know what you get. You care about how the content escalates. Also note that each of the sentences is more than just the title of the section. The actual title of Section 6 is just 'Time complexity'. * Conclusions that don't: His solution is literally the opposite of what is taught. Yes to a perspective, no to new information. Also his example is incomplete, three more sentences follow that are not summarizing.

anon946 5y ago
Can't speak for others, but I rarely, if ever, look at the table of contents paragraph. The reason is that I find it faster and more convenient to simply scan the section headings, since most CS papers are relatively short.
anticristi 5y ago
I still give these sins to my PhD students. * Table of contents: The 'inline' ToC, proposed by the author, is way more aesthetical and terse. * Grandmothering: Don't grandmother. Either be pedagogical or skip to the meat. * Conclusion: I nowadays prefer the paper-paper-paper format: The abstract is the whole paper, the introduction is the whole paper and the paper is the whole paper. Just the "zoom" level differs. Hence, the conclusion should really bring something new.
sfink 5y ago
You raise good points, but I'm largely with the author. * grandmothering: The author's examples weren't actually about orienting the paper in the field. They were giving redundant background material on the field itself. I think the distinction was not made clear. If I were to speak for the author, I'd say that it's not about dropping these introductory sentences, it's about making them say something useful to somebody. Orienting a paper's place in the field is useful. Telling me that distributed computing deals with scalable problems is not. * I have never, ever used the textual table of contents to find my way around. If it was guaranteed that section numbers were included, I might train myself to rarely get some use out of it. If there are no section numbers, it is worse than useless, and sometimes indistinguishable from bragging: "first, we propose a novel algorithm. Next, we prove that it is brilliant. Later, we show how it's what you wish you could have come up with but didn't. Finally, we describe what a loser you would have to be to not recognize our brilliance." * It may be the opposite of what is taught, but this is the one that I feel most strongly that the author is 100% correct. If you want a summary, read the abstract. If you want rambling about where this fits in with other stuff, read the introduction. The conclusion may not be needed, but at its best, it's where the gold is. It's not about what you did, it's about why you did it and why other people should care. The rest of the paper is about closing off an open problem. The conclusion should be about what new things your contribution opens up. The exhortation against new information is still accurate, it's just that it's more nuanced than that. Don't put in new information that's relevant to the problem you're addressing and the solution you've come up with. But do put in new information about things not addressed in the rest of the paper. There's prior work, which should be referenced in the introduction. There's your work, which is described in the body of the paper. There's future work, which is for the conclusion. There's also the layer above, the wider meaning and ramifications of your work; that's also for the conclusion. "What useful insight can I provide as a result of burying my head in this problem for months or years?"
- scrubs 5y ago
  You got it. It's like compression/information-content: add value aligned with thesis. Eliminate noise.
- rrobukef 5y ago

anon946 5y ago

Can't speak for others, but I rarely, if ever, look at the table of contents paragraph. The reason is that I find it faster and more convenient to simply scan the section headings, since most CS papers are relatively short.

anticristi 5y ago

I still give these sins to my PhD students. * Table of contents: The 'inline' ToC, proposed by the author, is way more aesthetical and terse. * Grandmothering: Don't grandmother. Either be pedagogical or skip to the meat. * Conclusion: I nowadays prefer the paper-paper-paper format: The abstract is the whole paper, the introduction is the whole paper and the paper is the whole paper. Just the "zoom" level differs. Hence, the conclusion should really bring something new.

sfink 5y ago

You raise good points, but I'm largely with the author. * grandmothering: The author's examples weren't actually about orienting the paper in the field. They were giving redundant background material on the field itself. I think the distinction was not made clear. If I were to speak for the author, I'd say that it's not about dropping these introductory sentences, it's about making them say something useful to somebody. Orienting a paper's place in the field is useful. Telling me that distributed computing deals with scalable problems is not. * I have never, ever used the textual table of contents to find my way around. If it was guaranteed that section numbers were included, I might train myself to rarely get some use out of it. If there are no section numbers, it is worse than useless, and sometimes indistinguishable from bragging: "first, we propose a novel algorithm. Next, we prove that it is brilliant. Later, we show how it's what you wish you could have come up with but didn't. Finally, we describe what a loser you would have to be to not recognize our brilliance." * It may be the opposite of what is taught, but this is the one that I feel most strongly that the author is 100% correct. If you want a summary, read the abstract. If you want rambling about where this fits in with other stuff, read the introduction. The conclusion may not be needed, but at its best, it's where the gold is. It's not about what you did, it's about why you did it and why other people should care. The rest of the paper is about closing off an open problem. The conclusion should be about what new things your contribution opens up. The exhortation against new information is still accurate, it's just that it's more nuanced than that. Don't put in new information that's relevant to the problem you're addressing and the solution you've come up with. But do put in new information about things not addressed in the rest of the paper. There's prior work, which should be referenced in the introduction. There's your work, which is described in the body of the paper. There's future work, which is for the conclusion. There's also the layer above, the wider meaning and ramifications of your work; that's also for the conclusion. "What useful insight can I provide as a result of burying my head in this problem for months or years?"

scrubs 5y ago
You got it. It's like compression/information-content: add value aligned with thesis. Eliminate noise.
rrobukef 5y ago