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" <rfligh...@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 <jdnew...@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 <jhe...@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@r-project.org mailing list >> https://stat.ethz.ch/mailman/listinfo/r-package-devel >> -- Sent from my phone. Please excuse my brevity. ______________________________________________ R-package-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-package-devel