Som bacheloroppgave utvikler jeg litt programvare (et hånlig rammeverk for MATLAB). Som sådan trenger jeg ofte å referere til programvaredokumentasjon – både fra MATLAB og programvaren som fungerer som min inspirasjon. Det ville også være fint å kunne referere til dokumentasjonen for den spesifikke funksjonen jeg refererer til (analogen med å referere til en bestemt side i en bok). Imidlertid har jeg mest tilgang til denne dokumentasjonen online og etter sin art har den en tendens bare i elektronisk form, som egentlig ikke er anbefalt i publisering. Så langt er det beste jeg har funnet på dette: 

@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 strengt tatt , dette er ikke en del av de offisielle dokumentene, men det tjener samme formål: det er en spesifikk side og den er bare tilgjengelig online)

Spesifikke spørsmål:

  • Hvem skal være forfatteren? I tilfelle MATLAB antar jeg at det er Mathworks eller en slik; Jeg antar at oppføring av åpen kildekode-prosjekter som «xx-utviklere» er det beste jeg kan gjøre.
  • Hvordan skal jeg nevne versjonen? Urldate hjelper generelt, men hvis jeg refererer til en bestemt programvareversjon, hvor skal jeg legge denne informasjonen? I tittelen?
  • Er det noen «offisielle» MATLAB sitatanbefalinger? MATLAB brukes mye i forskning, kanskje det er en foreslått måte å gjøre det på, og jeg savner det bare. Resten av spørsmålet gjelder fortsatt for annen programvare.

Kommentarer

  • Relatert (duplikat?): academia.stackexchange.com/q/5482/ 102
  • Også noe relatert: academia.stackexchange.com/questions/8098/…
  • prosjekter med åpen kildekode forteller deg ofte hvordan du skal sitere, f.eks. matplotlib.org/citing.html
  • " Gjør ditt beste, og ikke ' t bekymre deg for mye om det. " Dette var offisielle anvisninger som ble gitt om Internett-ressurser før Academia begynte å innhente teknologien og innse at nettsteder var interessante. Hvis du har noe som ikke har noen kategori, kan du bare velge et annet format som har noen regler, og tilpasse deg så godt du kan. Hvis ingen instruksjoner stemmer overens, vant de fleste klassinger ' t straffe deg for noe som ikke har noen klare instruksjoner / presedens. Hvis du kommer til å bli bedømt / vurdert av noen som kan gi deg støtte på forhånd, sjekk resultatene dine før innlevering

Svar

Generelt vil jeg behandle programvaredokumentasjon avhengig av hvordan den distribueres.

  • Hvis den publiseres i bokform, bør den siteres som en bok. Versjonsnummeret går der du vil legge utgaven, og firmaet som produserer programvaren er «utgiveren.»

  • Hvis manualen distribueres elektronisk, bør du sitere nettsted som det er hentet fra som «kilde».

  • Et unntak fra dette er hvis du i dokumentasjonen blir bedt om å referere til et bestemt arbeid (for eksempel en forskningsartikkel , eller et nettsted) når du siterer en kode. Så bør du følge den spesifikke veiledningen.

Svar

I tillegg til @aeismail » s svar:

  • I mitt felt er det vanlig å referere til Matlab i teksten «Matlab versjon XY (The Mathworks, USA)»

  • som @Bitwise kommentarer, vitenskapelig FOSS spesifiserer ofte hvordan man siterer. Så vi refererer f.eks til R som en vanlig bok. Rs anbefalte sitering inkluderer versjonen.

  • Hvis versjonen ikke er inkludert i det anbefalte sitatet, jeg la det inn i notatfeltet (Bibtex) – det er R-måten å sette sammen slike sitater på: 

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

  • Hvis det er en «normal» publikasjon, kombinerer jeg de vanlige siteringsdataene med ytterligere URL- og versjonsinformasjon: 

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

    (Her gjør jeg ikke » t trenger en ekstra dato, fordi utgivelsesdatoen er inkludert i versjonsnummeret.

  • Jeg har brukt annen FOSS-programvare der jeg ikke fant spesifikasjoner, så jeg spurte utviklingen pers hvordan de vil bli sitert.
    Erfaringen er at utviklerne vanligvis er veldig glade for denne typen spørsmål.

Legg igjen en kommentar

Din e-postadresse vil ikke bli publisert. Obligatoriske felt er merket med *