4 ms·
Give a big picture overview, categorize similar things, focus (omit unnecessary detail), mention similarities to known systems, don't assume highly specialized
by ahartmetz 9y ago
Give a big picture overview, categorize similar things, focus (omit unnecessary detail), mention similarities to known systems, don't assume highly specialized knowledge just to save a little space - the usual techniques to explain things!
Edit: If you look at a text, you can easily see whether or not the author can or wants to make themselves clear. Papers from after roughly 1980 just don't give that impression anymore. You also know the difference between good and bad software documentation when you see it, if that is closer to your area of expertise. I think your explanation is plausible, but wrong.
- SubiculumCode 9y agoThat is fine for reviews. I 'm not sure that is appropriate or even possible in empirical reports.