Ca teză de licență, dezvolt un software (un cadru de batjocură pentru MATLAB). Ca atare, de multe ori trebuie să fac referire la documentația software – atât de la MATLAB, cât și software-ul care îmi servește drept inspirație. Ar fi, de asemenea, frumos să pot face referire la documentația caracteristicii specifice la care mă refer (analogul de referință la o anumită pagină dintr-o carte). Cu toate acestea, acces în mare parte la această documentație online și, prin natura sa, tinde să existe doar în formă electronică, ceea ce nu este chiar recomandat în publicare. Până acum, cel mai bun lucru pe care l-am venit este: 

@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 strict vorbind , aceasta nu face parte din documentele oficiale, dar are același scop: este o pagină specifică și este disponibilă numai online)

Întrebări specifice:

  • Cine ar trebui să fie autorul? În cazul MATLAB, cred că este Mathworks sau ceva; Cred că enumerarea proiectelor open-source ca „dezvoltatori xx” este cel mai bun lucru pe care îl pot face.
  • Cum ar trebui să menționez versiunea? Urldate ajută în general, dar dacă mă refer la o anumită versiune de software, unde ar trebui să pun aceste informații? În titlu?
  • Există recomandări de citare MATLAB „oficiale”? MATLAB se folosește foarte mult în cercetare, probabil că există un mod de a-l sugera și chiar îl lipsesc. Restul întrebării se aplică totuși pentru alte programe.

Comentarii

  • În legătură (duplicat?): academia.stackexchange.com/q/5482/ 102
  • De asemenea, oarecum legat: academia.stackexchange.com/questions/8098/…
  • proiectele open source vă spun adesea cum să citați, de ex. matplotlib.org/citing.html
  • ” Faceți tot posibilul și nu ‘ t vă faceți griji prea mult. ” Acestea au fost indicații oficiale oferite despre resursele Internet înainte ca Academia să înceapă să ajungă la curent cu tehnologia și să realizeze că site-urile web erau interesante. Dacă aveți ceva care nu are nicio categorie, alegeți pur și simplu un alt format care are anumite reguli și adaptați-vă cât mai bine. Dacă nicio instrucțiune nu se potrivește în mod clar, majoritatea elevilor ‘ nu te penalizează pentru ceva care nu are instrucțiuni / precedente clare. Dacă veți fi judecat / notat de cineva care vă poate oferi asistență din timp, verificați rezultatele înainte de trimitere

Răspundeți

În general, aș trata documentația software în funcție de modul în care este distribuită.

  • Dacă este publicată sub formă de carte, atunci ar trebui citată ca o carte. Numărul versiunii merge unde ați pune ediția, iar compania care produce software-ul este „editorul”.

  • Dacă manualul este distribuit electronic, ar trebui să citați site-ul web de pe care este obținut ca „sursă”.

  • O excepție este dacă vi se solicită în documentație să faceți referire la o lucrare specifică (de exemplu, un articol de cercetare) , sau un site web) la citarea unui cod. Apoi, ar trebui să urmați îndrumările specifice furnizate.

Răspundeți

Pe lângă @aeismail ” Răspuns:

  • În câmpul meu este obișnuit să mă refer la Matlab în textul „Matlab versiunea XY (The Mathworks, SUA)”

  • ca @Bitwise comentarii, FOSS științific specifică adesea cum se citează. Deci, ne referim, de exemplu, la R ca o carte normală. Citarea recomandată de R include versiunea.

  • Dacă versiunea nu este inclusă în citarea recomandată, am introdus-o în câmpul de notă (Bibtex) – acesta este modul R de a pune împreună astfel de citări: 

    > 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}, }

  • Dacă există o publicație „normală”, combin datele de referință normale cu informații suplimentare despre adresele URL și versiunea: 

    > 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}, }

    (Aici, eu nu ” Nu am nevoie de o dată suplimentară, deoarece data lansării este inclusă în numărul versiunii.

  • Am folosit alt software FOSS în care nu am găsit o specificație, așa că am întrebat develo pers cum vor să fie citați.
    Experiența este că dezvoltatorii sunt de obicei foarte încântați de acest tip de întrebare.

Lasă un răspuns

Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *