[R-pkg-devel] First R package, want to release to CRAN, have some questions about R CMD check and README.md

[Jeff Newmiller]

Apparently I am behind the times... both README (plain text) and README.md (markdown) are now recognized files by R. But the Rmd file does need to be ignored.

On March 7, 2020 4:09:03 PM PST, "Robert M. Flight" <rflight79 using gmail.com> wrote:
>Umm, but README.md becomes README.html on CRAN, and it is very nice to
>have.
>
>I'm not sure what the error you are seeing is, but having README on
>CRAN is
>nice.
>
>Have you .Rbuildignore 'd README.Rmd?? That should be ignored if I
>remember
>correctly.
>
>-Robert
>
>On Sat, Mar 7, 2020, 5:55 PM Jeff Newmiller <jdnewmil using dcn.davis.ca.us>
>wrote:
>
>> README.md is a github convention... do not try to treat it like part
>of
>> the R package documentation. Instead, list it in your .Rbuildignore
>file
>> and use it to inform developers how to change the package and to
>direct
>> (potential) users browsing the GitHub repo to read the more
>conventional R
>> documentation of vignettes.
>>
>> On March 7, 2020 1:55:24 PM PST, Jeffry Hesse <jhesse using sonatype.com>
>wrote:
>> >Hi there!
>> >
>> >I and a few others have been working on an R package we'd like to
>get
>> >on
>> >CRAN. The package itself checks R dependencies to see if they have a
>> >known
>> >CWE or CVE attached to them, and is intended to help R developers
>get a
>> >better understanding on the quality of the dependencies they use!
>> >
>> >An example of it running is here:
>> >
>> >
>>
>https://61-244738782-gh.circle-artifacts.com/0/~/oysteR/oysteR.Rcheck/00install.out
>> >
>> >And example of the output of R CMD check is here:
>> >
>> >
>>
>https://61-244738782-gh.circle-artifacts.com/0/~/oysteR/oysteR.Rcheck/00check.log
>> >
>> >I have had some confusing experiences thus far with a README.md
>file,
>> >and
>> >excluded it in our .Rbuildignore, because I kept getting:
>> >
>> >* checking top-level files ... WARNING
>> >Conversion of ‘README.md’ failed:
>> >"template" (line 18, column 17):
>> >unexpected "("
>> >expecting "." or "$"
>> >
>> >This error is very cryptic to me, and I couldn't figure it out after
>a
>> >bunch of wonderful googling :)
>> >
>> >The README.rmd file is here:
>>
>>https://github.com/sonatype-nexus-community/oysteR/blob/master/README.Rmd
>> >
>> >Output README.md generated with rmarkdown is here:
>> >
>>
>https://raw.githubusercontent.com/sonatype-nexus-community/oysteR/master/README.md
>> >
>> >Ideally I think it would be nice to include it in our R package, but
>> >that
>> >WARNING keeps scaring me :)
>> >
>> >If anyone has any insight into the cause of that warning, would love
>to
>> >know.
>> >
>> >Any other feedback on the package would be great too! I'm not an R
>> >developer by trade (but love it), and this is my first go at this.
>> >Figured
>> >I'd reach out here to hopefully help save some back and forth
>between
>> >CRAN
>> >maintainers when I go to submit.
>> >
>> >CODE: https://github.com/sonatype-nexus-community/oysteR
>> >
>> >Also, we are actively looking for contributors that want to help
>out,
>> >so if
>> >this project interests you, come on over!
>> >
>> >Cheers, and thanks in advance for any help!
>>
>> --
>> Sent from my phone. Please excuse my brevity.
>>
>> ______________________________________________
>> R-package-devel using r-project.org mailing list
>> https://stat.ethz.ch/mailman/listinfo/r-package-devel
>>

-- 
Sent from my phone. Please excuse my brevity.