En tant que thèse de mon baccalauréat, je développe un logiciel (un framework de simulation pour MATLAB). En tant que tel, jai souvent besoin de faire référence à la documentation du logiciel – à la fois de MATLAB et du logiciel qui me sert dinspiration. Ce serait aussi bien de pouvoir référencer la documentation de la fonctionnalité spécifique à laquelle je fais référence (lanalogue du référencement dune page spécifique dans un livre). Cependant, jaccède principalement à cette documentation en ligne et de par sa nature elle a tendance à exister juste sous forme électronique, ce qui nest pas vraiment recommandé dans la publication. Jusquà présent, le meilleur que jai trouvé est celui-ci:
@misc{mockitoFeatures, author = {{\em mockito} developers}, title = {Features and Motivations}, note = {\url{https://code.google.com/p/mockito/wiki/FeaturesAndMotivations}}, urldate = {2013-04-24}, } (ok à proprement parler , ceci ne fait pas partie de la documentation officielle mais sert le même objectif: cest une page spécifique et elle nest disponible quen ligne)
Questions spécifiques:
- Qui devrait être lauteur? Dans le cas de MATLAB, je suppose que cest Mathworks ou quelque chose du genre; Je suppose que lister les projets open-source en tant que « développeurs xx » est le mieux que je puisse faire.
- Comment dois-je mentionner la version? Urldate aide en général, mais si je « fais référence à une version de logiciel particulière, où dois-je mettre ces informations? Dans le titre?
- Y a-t-il des recommandations de citation MATLAB « officielles »? MATLAB est beaucoup utilisé dans la recherche, peut-être existe-t-il une méthode suggérée pour le faire et je la manque juste. Le reste de la question sapplique toujours à dautres logiciels, cependant.
Commentaires
- Liés (en double?): academia.stackexchange.com/q/5482/ 102
- Également assez proche: academia.stackexchange.com/questions/8098/…
- les projets open source vous indiquent souvent comment citer, par exemple matplotlib.org/citing.html
- » Faites de votre mieux et ne ‘ t » Ce sont des instructions officielles fournies sur les ressources Internet avant que Academia ne commence à rattraper la technologie et à se rendre compte que les sites Web sont intéressants. Si vous avez quelque chose qui na pas de catégorie, choisissez simplement un autre format comportant des règles et adaptez-vous du mieux que vous pouvez. Si aucune instruction ne correspond clairement, la plupart des évaluateurs ‘ ne vous pénaliseront pas pour quelque chose qui n’a pas d’instructions / de précédents clairs. Si vous allez être jugé / noté par quelquun qui peut vous fournir une assistance à lavance, vérifiez vos résultats avant de les soumettre
Réponse
En général, je traiterais la documentation du logiciel en fonction de la façon dont elle est distribuée.
-
Si elle est publiée sous forme de livre, alors elle doit être citée comme un livre. Le numéro de version va là où vous mettriez lédition, et la société qui fabrique le logiciel est l «éditeur».
-
Si le manuel est distribué par voie électronique, vous devez citer le site Web à partir duquel il est obtenu comme « source ».
-
Une exception à cela est si la documentation vous demande de faire référence à un travail spécifique (par exemple, un article de recherche , ou un site Web) lors de la citation dun code. Ensuite, vous devez suivre les instructions spécifiques fournies.
Réponse
En plus de @aeismail » Réponse de s:
- Dans mon domaine, il est courant de faire référence à Matlab dans le texte « Matlab version XY (The Mathworks, USA) »
-
comme @Bitwise commentaires, le logiciel libre scientifique spécifie souvent comment citer. Ainsi, nous nous référons par exemple à R comme un livre normal. La citation recommandée par R inclut la version.
-
Si la version nest pas incluse dans la citation recommandée, je la mets dans le champ de note (Bibtex) – cest la façon R de rassembler de telles citations:
> citation ("cbmodels") To cite package ‘cbmodels’ in publications use: C. Beleites (2013). cbmodels: Collection of "combined" models: PCA-LDA, PLS-LDA, etc.. R package version 0.5-20130417. A BibTeX entry for LaTeX users is @Manual{, title = {cbmodels: Collection of "combined" models: PCA-LDA, PLS-LDA, etc.}, author = {C. Beleites}, year = {2013}, note = {R package version 0.5-20130417}, } -
Sil y a une publication « normale », je combine les données de citation normales avec des informations supplémentaires sur lURL et la version:
> citation ("softclassval") To cite package "softclassval" please use: Claudia Beleites, Reiner Salzer and Valter Sergo: "Validation of Soft Classification Models using Partial Class Memberships: An Extended Concept of Sensitivity & Co. applied to grading of astrocytoma tissues", Chemometrics and Intelligent Laboratory Systems, 122 (2013), 12 - 22, DOI: 10.1016/j.chemolab.2012.12.003, arXiv: 1301.0264, R package version 1.0-20130318, http://softclassval.r-forge.r-project.org. A BibTeX entry for LaTeX users is @Article{, title = {Validation of Soft Classification Models using Partial Class Memberships: An Extended Concept of Sensitivity & Co. applied to Grading of Astrocytoma Tissues}, author = {Claudia Beleites and Reiner Salzer and Valter Sergo}, year = {2013}, number = {122}, pages = {12 -- 22}, journal = {Chemometrics and Intelligent Laboratory Systems}, note = {R package version 1.0-20130318}, url = {http://softclassval.r-forge.r-project.org}, doi = {10.1016/j.chemolab.2012.12.003}, eprint = {http://arxiv.org/abs/1301.0264}, }(Ici, je ne » Jai besoin dune date supplémentaire, car la date de sortie est incluse dans le numéro de version.
-
Jutilise un autre logiciel FOSS où je nai pas trouvé de spécification, alors jai demandé le développement pers comment ils veulent être cités.
Lexpérience est que les développeurs sont généralement très satisfaits de ce genre de question.