search

openmainframeproject / ade

ADE detects anomalous time slices and messages in Linux logs (either RFC3164 or RFC5424 format) using statistical learning.
https://www.openmainframeproject.org/projects/anomaly-detection-engine-for-linux-logs-ade
GNU General Public License v3.0
51 stars 34 forks source link

JOSS review: Writing style in paper #87

Open mdpiper opened 3 years ago

mdpiper commented 3 years ago

This issue is raised in reference to JOSS submission 3052.

The writing style in the paper is colloquial; in particular, the sections Statement of Need and Novelties. The language is understandable (I enjoyed reading the paper!), but it's suited more for a magazine article or a blog post. Since JOSS is an academic journal, the language needs to be more precise. The paper in general, and the sections mentioned above in particular, should be edited to reduce verbosity and use more precise language.

mdpiper commented 3 years ago

A suggestion that may help: take a look at some recent JOSS papers to see the tone that's used.

ayush-1506 commented 3 years ago

Got it, thanks. I'll make the sections more concise and to-the-point. Will also make other major edits in the Novelties section.