Adrian, I am not on the CRAN or R-core teams, so the following is my own view, but...> library(QCA) > > Users are encouraged to cite this package as: > > Dusa, Adrian (2015). QCA: Qualitative Comparative Analysis. R Package > Version 1.2-0, > URL: http://cran.r-project.org/package=QCA > > This is just an encouragement, not a requirement, and the official citation > file meets the CRAN policies. Would that be acceptable? >At the very least, this is seems to be a flagrant violation of the *spirit* of the CRAN policy, which AFAIK is intended to enforce acknowledgement of the contributions of all copyright holders in the package. The fact that you are trying to bypass the policy by suggesting users use an unofficial citation which would not comply with the policy while maintaining an official one which complies, but which you don't want users to see is probably a suggestion that you shouldn't do that. Best, ~G> > Best wishes, > Adrian > > > -- > Adrian Dusa > University of Bucharest > Romanian Social Data Archive > Soseaua Panduri nr.90 > 050663 Bucharest sector 5 > Romania > > [[alternative HTML version deleted]] > > ______________________________________________ > R-devel at r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel >-- Gabriel Becker, PhD Computational Biologist Bioinformatics and Computational Biology Genentech, Inc. [[alternative HTML version deleted]]
Hi Gabriel, On Tue, Oct 6, 2015 at 10:59 PM, Gabriel Becker <gmbecker at ucdavis.edu> wrote:> [...] > > At the very least, this is seems to be a flagrant violation of the > *spirit* of the CRAN policy, which AFAIK is intended to enforce > acknowledgement of the contributions of all copyright holders in the > package. The fact that you are trying to bypass the policy by suggesting > users use an unofficial citation which would not comply with the policy > while maintaining an official one which complies, but which you don't want > users to see is probably a suggestion that you shouldn't do that. >But that is the very point: I read the CRAN policies twice, and there is no official guideline on how to compile the citation. Regarding the Source packages, the policies mention: ###### The ownership of copyright and intellectual property rights of all components of the package must be clear and unambiguous (including from the authors specification in the DESCRIPTION file). Where code is copied (or derived) from the work of others (including from R itself), care must be taken that any copyright/license statements are preserved and authorship is not misrepresented. Preferably, an ?Authors at R? would be used with ?ctb? roles for the authors of such code. Alternatively, the ?Author? field should list these authors as contributors. Where copyrights are held by an entity other than the package authors, this should preferably be indicated via ?cph? roles in the ?Authors at R? field, or using a ?Copyright? field (if necessary referring to an inst/COPYRIGHTS file). Trademarks must be respected. ###### Now, that requirement is already met: the former author is still in the authors' list. So the contribution of the former author is duly acknowledged, but the fundamental issue of my question related to the citation file, for which the CRAN policies doesn't offer any other information. If the spirit of the CRAN policies is to enforce citing each and every one of the authors, then I don't understand why the citation from package Rcmdr meets this spirit, while my suggestion doesn't. I apologize for pushing this topic to the limit, but I haven't got an answer to this question yet... Best wishes, Adrian PS: @Thierry: I did take a look at RODBC, but the citation information is generated automatically upon package installation (no other special file on CRAN) -- Adrian Dusa University of Bucharest Romanian Social Data Archive Soseaua Panduri nr.90 050663 Bucharest sector 5 Romania [[alternative HTML version deleted]]
On Tue, Oct 6, 2015 at 11:58 PM, Adrian Du?a <dusa.adrian at unibuc.ro> wrote:> > [...] > If the spirit of the CRAN policies is to enforce citing each and everyone of the authors, then I don't understand why the citation from package Rcmdr meets this spirit, while my suggestion doesn't.> > I apologize for pushing this topic to the limit, but I haven't got ananswer to this question yet... Out of curiosity, upon random checks there seem to be many other packages in similar situations (which have multiple authors, but cite only a subset): SamplingStrata sandwich SAVE seawave What all of these cases seem to have in common is an older published journal article, and the citation adhered to that article irrespective of how many authors subsequently contributed to that package. Would it suffice to provide such an article, then? Adrian -- Adrian Dusa University of Bucharest Romanian Social Data Archive Soseaua Panduri nr.90 050663 Bucharest sector 5 Romania [[alternative HTML version deleted]]
Adrian, Responses inline On Tue, Oct 6, 2015 at 1:58 PM, Adrian Du?a <dusa.adrian at unibuc.ro> wrote:> Hi Gabriel, > > On Tue, Oct 6, 2015 at 10:59 PM, Gabriel Becker <gmbecker at ucdavis.edu> > wrote: > >> [...] >> >> At the very least, this is seems to be a flagrant violation of the >> *spirit* of the CRAN policy, which AFAIK is intended to enforce >> acknowledgement of the contributions of all copyright holders in the >> package. The fact that you are trying to bypass the policy by suggesting >> users use an unofficial citation which would not comply with the policy >> while maintaining an official one which complies, but which you don't want >> users to see is probably a suggestion that you shouldn't do that. >> > > > But that is the very point: I read the CRAN policies twice, and there is > no official guideline on how to compile the citation. > Regarding the Source packages, the policies mention: >> ###### > The ownership of copyright and intellectual property rights of all > components of the package must be clear and unambiguous (including from the > authors specification in the DESCRIPTION file). Where code is copied (or > derived) from the work of others (including from R itself), care must be > taken that any copyright/license statements are preserved and authorship is > not misrepresented. > Preferably, an ?Authors at R? would be used with ?ctb? roles for the authors > of such code. Alternatively, the ?Author? field should list these authors > as contributors. > > Where copyrights are held by an entity other than the package authors, > this should preferably be indicated via ?cph? roles in the ?Authors at R? > field, or using a ?Copyright? field (if necessary referring to an > inst/COPYRIGHTS file). > > Trademarks must be respected. > ###### > > Now, that requirement is already met: the former author is still in the > authors' list. So the contribution of the former author is duly > acknowledged, but the fundamental issue of my question related to the > citation file, for which the CRAN policies doesn't offer any other > information. >The citation mechanism, AFAIK, has two purposes. One is to associate a published article/book/etc with an r package, where appropriate (and there authorship and inclusion would need to meet the requirements of the publishing journal). The other is to give a way for other works to cite the work done in developing the package. If you don't acknowledge that it is "heavily implied" that in the second case all authors of the package should appear in the citation (this is almost definitionally true of citations, I would think) I'm not really sure what to tell you. Approached from a different angle, what reason do you have for wanting the other other to not appear in the citation for the package other than minimizing/not acknowledging the copyright-holding work that he or she did on the project?> > If the spirit of the CRAN policies is to enforce citing each and every one > of the authors, then I don't understand why the citation from package Rcmdr > meets this spirit, while my suggestion doesn't. >I don't have any knowledge of what Rcmdr does with regards to the citations or the historical context that would make it relevant to the discussion here.> > I apologize for pushing this topic to the limit, but I haven't got an > answer to this question yet... >With respect, not receiving the answer you wanted isn't the same as not receiving an answer. Best, ~G> > Best wishes, > Adrian > > PS: @Thierry: I did take a look at RODBC, but the citation information is > generated automatically upon package installation (no other special file on > CRAN) > > -- > Adrian Dusa > University of Bucharest > Romanian Social Data Archive > Soseaua Panduri nr.90 > 050663 Bucharest sector 5 > Romania >-- Gabriel Becker, PhD Computational Biologist Bioinformatics and Computational Biology Genentech, Inc. [[alternative HTML version deleted]]
On Tue, Oct 6, 2015 at 4:58 PM, Adrian Du?a <dusa.adrian at unibuc.ro> wrote:> Hi Gabriel, > > On Tue, Oct 6, 2015 at 10:59 PM, Gabriel Becker <gmbecker at ucdavis.edu> > wrote: > >> [...] >> >> At the very least, this is seems to be a flagrant violation of the >> *spirit* of the CRAN policy, which AFAIK is intended to enforce >> acknowledgement of the contributions of all copyright holders in the >> package. The fact that you are trying to bypass the policy by suggesting >> users use an unofficial citation which would not comply with the policy >> while maintaining an official one which complies, but which you don't want >> users to see is probably a suggestion that you shouldn't do that. >> > > > But that is the very point: I read the CRAN policies twice, and there is no > official guideline on how to compile the citation. > Regarding the Source packages, the policies mention: > > ###### > The ownership of copyright and intellectual property rights of all > components of the package must be clear and unambiguous (including from the > authors specification in the DESCRIPTION file). Where code is copied (or > derived) from the work of others (including from R itself), care must be > taken that any copyright/license statements are preserved and authorship is > not misrepresented. > Preferably, an ?Authors at R? would be used with ?ctb? roles for the authors > of such code. Alternatively, the ?Author? field should list these authors > as contributors. > > Where copyrights are held by an entity other than the package authors, this > should preferably be indicated via ?cph? roles in the ?Authors at R? field, or > using a ?Copyright? field (if necessary referring to an inst/COPYRIGHTS > file). > > Trademarks must be respected. > ###### > > Now, that requirement is already met: the former author is still in the > authors' list. So the contribution of the former author is duly > acknowledged, but the fundamental issue of my question related to the > citation file, for which the CRAN policies doesn't offer any other > information. > > If the spirit of the CRAN policies is to enforce citing each and every one > of the authors, then I don't understand why the citation from package Rcmdr > meets this spirit, while my suggestion doesn't.I'd recommend that you read https://cran.r-project.org/web/packages/shiny/DESCRIPTION and compare it to citation("shiny"). Authors, but not contributors, all listed in the citation. Hadley -- http://had.co.nz/