Come mia tesi di laurea, sto sviluppando del software (un framework beffardo per MATLAB). Pertanto, spesso ho bisogno di fare riferimento alla documentazione del software, sia di MATLAB che del software che mi serve da ispirazione. Sarebbe anche bello poter fare riferimento alla documentazione della caratteristica specifica a cui mi riferisco (lanalogo del riferimento a una pagina specifica in un libro). Tuttavia, accedo principalmente a questa documentazione online e per sua natura tende ad esistere solo in formato elettronico, che non è veramente raccomandato nella pubblicazione. Finora, il meglio che ho trovato è questo:
@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 in senso stretto , questo non fa parte dei documenti ufficiali ma ha lo stesso scopo: è “una pagina specifica ed è disponibile solo online)
Domande specifiche:
- Chi dovrebbe essere lautore? Nel caso di MATLAB immagino che sia “Mathworks o qualcosa del genere; Immagino che elencare i progetti open source come “sviluppatori xx” sia il meglio che posso fare.
- Come dovrei menzionare la versione? Urldate aiuta in generale, ma se mi riferisco a una particolare versione del software, dove devo inserire queste informazioni? Nel titolo?
- Ci sono raccomandazioni “ufficiali” per le citazioni MATLAB? MATLAB è molto usato nella ricerca, forse cè” un modo suggerito per farlo e me lo sto perdendo. Il resto della domanda vale ancora per altri software, però.
Commenti
- Correlati (duplicati?): academia.stackexchange.com/q/5482/ 102
- Anche in qualche modo correlato: academia.stackexchange.com/questions/8098/…
- I progetti open source spesso ti dicono come citare, ad esempio matplotlib.org/citing.html
- ” Fai del tuo meglio e non ‘ preoccuparti troppo. ” Queste erano le indicazioni ufficiali fornite sulle risorse Internet prima che Academia iniziasse a mettersi al passo con la tecnologia e rendersi conto che i siti web erano interessanti. Se hai qualcosa che non ha categoria, scegli semplicemente un altro formato che abbia alcune regole e adattalo nel miglior modo possibile. Se nessuna istruzione corrisponde chiaramente, la maggior parte degli alunni ‘ ti penalizzerà per qualcosa che non ha istruzioni chiare / precedenti. Se stai per essere giudicato / valutato da qualcuno che può fornirti supporto in anticipo, controlla i risultati prima dellinvio
Risposta
In generale, tratterò la documentazione del software a seconda di come è distribuito.
-
Se è pubblicata in forma di libro, allora dovrebbe essere citata come un libro. Il numero di versione va dove metteresti ledizione e la società che produce il software è l “editore”.
-
Se il manuale è distribuito elettronicamente, dovresti citare il sito web da cui si ottiene come “fonte”.
-
Uneccezione è se nella documentazione viene chiesto di fare riferimento a un lavoro specifico (ad esempio, un articolo di ricerca o un sito Web) quando si cita un codice. Quindi dovresti seguire la guida specifica fornita.
Answer
Oltre a @aeismail ” s risposta:
- Nel mio campo è comune fare riferimento a Matlab nel testo “Matlab version XY (The Mathworks, USA)”
-
come @Bitwise commenti, la FOSS scientifica spesso specifica come citare. Quindi ci riferiamo ad esempio a R come a un libro normale. La citazione raccomandata da R include la versione.
-
Se la versione non è inclusa in la citazione consigliata, lho inserita nel campo note (Bibtex) – questo è il modo R di mettere insieme tali citazioni:
> 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}, } -
Se esiste una pubblicazione “normale”, combino i dati della citazione normale con URL aggiuntivi e informazioni sulla versione:
> 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}, }(Qui, non ” Non ho bisogno di una data aggiuntiva, perché la data di rilascio è inclusa nel numero di versione.
-
Ho utilizzato altri software FOSS in cui non ho trovato una specifica, quindi ho chiesto il develo pers come vogliono essere citati.
Lesperienza è che gli sviluppatori di solito sono molto contenti di questo tipo di domande.