Submitting packages to CRAN is a notoriously finicky process that can lead to tremendous headaches over seemingly unimportant minutiae (although it does inspire epic twitter debates). Lately for me the real hurdle in the submission process is the DESCRIPTION file.
I've read the large section in the CRAN WRE, and but often I still miss things (my most common sin is that I forget to update the date field) that don't throw warnings in
R CMD CHECK --as-cran. I don't agree with these enforced minutiae, or the fact that my CRAN checks are different from the maintainers. However I accept the fact that if I want to use CRAN, I need to conform to their policies. A flaw in their policies though is they are not enforced by a computer and therefore the same person can give you conflicting interpretations of the policy. Here is my tale of woe with the package
I won't bore you with the whole story. Suffice to say originally the package was called
biorxiv, it let you search the bioRxiv preprint server from R. The initial problem was that the package has the same name as the service is searched. Now the CRAN DESCRIPTION policy states:
Refer to other packages and external software in single quotes, and to book titles (and similar) in double quotes.
So in my initial submission I used ' ' in referring to the package and not when referring to the website to try and disambiguate the two. However after many back and forth's with CRAN maintainers on this, I just acquiesced and changed the package name. The package was successfully submitted and all was well with the world. Until I got a notice it wasn't building last night. I quickly made a patch and submitted it. When I saw the e-mail from Brian Ripley this morning, I knew that bad news awaited. Here is what he said:
Please do check as per the policies. You missed
Possibly mis-spelled words in DESCRIPTION: PDFs (11:177, 11:275) bioRxiv (3:44, 11:18)
The Date field is over a month old.
In future single-quote 'bioRxiv' (see the manual) and pay attention to dates.
First, in the previous submission I did not quote 'bioRxiv', nor did I get any note. Secondly the policy clearly states that single quotes are used for software or other packages, but bioRxiv is a website. Also this was the exact same text from my first successful submission that I got a one line e-mail from Kurt saying "Thanks, on CRAN now." So why was not quoting it fine in the first submission but in the second submission I was told it violated CRAN policies? The only difference was that the first time Kurt responded to my submission vs. Ripley in the second. I don't have a good answer to this save it is an example of two different maintainers interpreting the same policy differently.
Second, you'll see two "possibly mis-spelled words". As before nothing was said about these in the first submission that was successful. But here's the curious thing. An initial submission was written saying "PDF's", however Ripley responded to my submission informing me:
The plural of PDF is PDFs
I corrected it to "PDF's" and my submission went on CRAN successfully. So early on he said "here's how you spell PDFs", but in my latest submission he calls it out as a mis-spelled word. So which is it? Why was it ok in the first submission but not the second? Finally why does
R CMD CHECK --as-cran not tell me these as warnings but it does for Ripley?
I doubt there's any malice in these discrepancies, but to me it highlights one of the shortcomings of using such human based submission system. In fact at this point I've probably spent almost as much time reworking the DESCRIPTION file as I have writing the package (to be fair it's a small package). So I can't help but wonder is this the best way to create a vibrant open source community? Where a few gate keepers inconsistently enforce policy on a package component that is completely unrelated to the software's functionality? I'm all for good package metadata, but that only works when the submission system is consistent.
I posted this last night with a CC to Gavin Simpson because I respect his opinion, he's a badass R programmer, is experienced in CRAN submission and he always has thoughtful rebuttals to the normal anti-CRAN echo chamber I can sometimes get caught up in on twitter. I wanted to present an alternative view point to my own. To paraphrase his response: The quote rule is likely intended for specific things, which a website is, not just software. CRAN policies are always evolving so don't get hung up on a legalistic reading of the policy, if they point something out, just change it (see the full twitter exchange).
And that's kind of where we're at as an R community. I may not like the system, but it's the system we have and I'd rather jump through hoops to submit to CRAN than throw my hands up and just leave my software on GitHub. To me the ease of access CRAN provides is more important than any ideological feelings I have. Maybe that will change some day though.→ ←