<p><div><div><div><div data-show-faces="false" data-height="21" data-width="100" data-layout="button_count" data-send="true" data-href="https://www.r-bloggers.com/writing-papers-about-packages/"></div></div><div></div></div><div></div></div>
<div>
(This article was first published on <strong><a href="http://msperlin.github.io/2018-03-16-Writing_Papers_About_Pkgs/"> Marcelo S. Perlin</a></strong>, and kindly contributed to <a rel="nofollow" href="https://www.r-bloggers.com/">R-bloggers)</a> </div>
<p> Some advices from a referee – </p>
<p>Back in 2007 I wrote a <a rel="nofollow" href="https://github.com/msperlin/MS_Regress-Matlab" target="_blank">Matlab package</a> for estimating regime switching models. I was just starting to learn to code and this project was my way of doing it. After publishing it in FEX (Matlab file exchange site) I got so many repeated questions on my email that eventually realized it would be easier to write a manual for people to read. Some time and effort would be spend writing it, but less time replying to repeated questions on my email.</p>
<p>This <a rel="nofollow" href="https://papers.ssrn.com/sol3/papers.cfm?abstract_id=1714016" target="_blank">manual</a> about the code became, by far, my most cited paper in <a rel="nofollow" href="https://scholar.google.com.br/citations?user=n3LTk-UAAAAJ&hl=en" target="_blank">Google Scholar</a>. It is not even published, just a permanent working paper. When attending conferences and seminars, I was always surprised to hear that people knew me as the <em>matlab regime switching</em> guy.</p>
<p>Moving forward a few years, I stopped using Matlab for R and I continue to invest a lot of time writing papers about packages and publishing them in standard scientific journals. You can see a list of those <a rel="nofollow" href="https://msperlin.github.io/content/loc_publications/" target="_blank">here</a>. I can testify for a greater contribution and impact for research papers about code. I strongly believe that it will become more popular in the years to come. The new generation of researchers is far more aware of code than the previous. In that sense, nothing beats R and CRAN at the diversity and depth of packages.</p>
<p>In this subject, I frequently review papers in the same topic and I see common mistakes that researchers do when writing their papers. Here’s some tips for those that wish to pursue such a publication:</p>
<ul>
<li>
<p><em>A problem must be clearly stated</em>: Every paper is a solution to a problem. This is also true for a paper about code. Identify it and make it painfully clear how the code solves it. In other words, do your homework.</p>
</li>
<li>
<p><em>The paper is NOT an extended manual</em>: Don’t write a paper simply showing its functions. We have that from CRAN (or other repository).</p>
</li>
<li>
<p><em>Make sure you know what’s available</em>: How people did it before? Is there a competing package? How does your code improves it?</p>
</li>
<li>
<p><em>A bibliometric study is mandatory</em>.: Same as the previous point. Looking at the previous published research papers, can you find out how they handled the problem your code solves?</p>
</li>
<li>
<p><em>Not everyone uses R, so make it easier for people to use you software</em>: Make sure you keep a simple and accessible code. Explain what is R and why you should use it. Case in point, not everyone know what a <em>tibble</em> is.</p>
</li>
<li>
<p><em>Think about your example of usage</em>: You should always add a reproducible example of usage. This is what everyone will try! Make sure it is a simple example, not too deep in the literature. Something everyone can understand. Your code should also be accessible and reproducible.</p>
</li>
</ul>
<p>It is a lot of work to publish a research paper about code. But, it is all worth it! The impact is much greater than a standard research paper. Your academic career will certainly move forward with it.</p>
	<p>
<div>
<div>To <strong>leave a comment</strong> for the author, please follow the link and comment on their blog: <strong><a href="http://msperlin.github.io/2018-03-16-Writing_Papers_About_Pkgs/"> Marcelo S. Perlin</a></strong>.</div>
<hr>
<a rel="nofollow" href="https://www.r-bloggers.com/">R-bloggers.com</a> offers <strong><a rel="nofollow" href="https://feedburner.google.com/fb/a/mailverify?uri=RBloggers">daily e-mail updates</a></strong> about <a rel="nofollow" href="https://www.r-project.org/" title="The R Project for Statistical Computing">R</a> news and <a rel="nofollow" href="https://www.r-bloggers.com/search/tutorial" title="R tutorials">tutorials</a> on topics such as: <a rel="nofollow" href="https://www.r-bloggers.com/search/data%20science" title="Data science">Data science</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/Big%20Data" title="Big Data">Big Data, <a rel="nofollow" href="https://www.r-users.com/" title="R jobs">R jobs</a>, visualization (<a rel="nofollow" href="https://www.r-bloggers.com/search/ggplot2" title="ggplot and ggplot2 tutorials">ggplot2</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/boxplot" title="Boxplots using lattice and ggplot2 tutorials">Boxplots</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/map" title="Maps and gis">maps</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/animation" title="Animation in R">animation</a>), programming (<a rel="nofollow" href="https://www.r-bloggers.com/search/RStudio" title="RStudio IDE for R">RStudio</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/sweave" title="Sweave and literate programming">Sweave</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/LaTeX" title="LaTeX in R">LaTeX</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/SQL" title="SQL and databases">SQL</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/eclipse" title="Eclipse IDE for R">Eclipse</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/git" title="git and github, Version Control System">git</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/hadoop" title="Large data in R using Hadoop">hadoop</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/Web+Scraping" title="Web Scraping of google, facebook, yahoo, twitter and more using R">Web Scraping</a>) statistics (<a rel="nofollow" href="https://www.r-bloggers.com/search/regression" title="Regressions and ANOVA analysis tutorials">regression</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/PCA" title="principal component analysis tutorial">PCA</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/time+series" title="Time series">time series</a>, <a rel="nofollow" href="https://www.r-bloggers.com/search/trading" title="finance trading">trading</a>) and more...
<img width="1" alt="" src="http://feeds.feedburner.com/~r/RBloggers/~4/QG4tDWumQwI" height="1"></a></div>