Som min bacheloropgave udvikler jeg noget software (en hånlig ramme for MATLAB). Som sådan har jeg ofte brug for at henvise til softwaredokumentation – både fra MATLAB og den software, der fungerer som min inspiration. Det ville også være rart at være i stand til at henvise til dokumentationen til den specifikke funktion, jeg henviser til (analogen med at henvise til en bestemt side i en bog). Jeg har dog mest adgang til denne dokumentation online, og efter sin art har den en tendens til at eksistere bare i elektronisk form, som ikke rigtig anbefales i publicering. Indtil videre er det bedste, jeg har fundet 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 taget , dette er ikke en del af de officielle dokumenter, men det tjener det samme formål: det er en bestemt side, og det er kun tilgængeligt online)

Specifikke spørgsmål:

  • Hvem skal være forfatteren? I tilfælde af MATLAB tror jeg det er Mathworks eller sådan; Jeg gætter på, at det er det bedste, jeg kan gøre, at open source-projekter er “xx-udviklere”.
  • Hvordan skal jeg nævne versionen? Urldate hjælper generelt, men hvis jeg henviser til en bestemt softwareversion, hvor skal jeg placere disse oplysninger? I titlen?
  • Er der nogen “officielle” MATLAB-henvisningsanbefalinger? MATLAB bruges meget i forskning, måske er der en foreslået måde at gøre det på, og jeg savner det bare. Resten af spørgsmålet gælder dog stadig for anden software.

Kommentarer

  • Relateret (duplikat?): academia.stackexchange.com/q/5482/ 102
  • Også lidt relateret: academia.stackexchange.com/questions/8098/…
  • open source-projekter fortæller dig ofte, hvordan du citerer, f.eks. matplotlib.org/citing.html
  • ” Gør dit bedste, og don ‘ t bekymre dig for meget om det. ” Dette var officielle anvisninger angående internetressourcer, inden Academia begyndte at indhente teknologien og indse, at websteder var interessante. Hvis du har noget, der ikke har nogen kategori, skal du blot vælge et andet format, der har nogle regler, og tilpasse dig så godt du kan. Hvis ingen instruktioner klart stemmer overens, vandt de fleste klassere ‘ t straffe dig for noget, der ikke har nogen klare instruktioner / præcedens. Hvis du bliver bedømt / bedømt af en person, der kan give dig support på forhånd, skal du kontrollere dine resultater inden indsendelse

Svar

Generelt behandler jeg softwaredokumentation afhængigt af, hvordan den distribueres.

  • Hvis den udgives i bogform, skal den citeres som en bog. Versionsnummeret går hvor du vil placere udgaven, og firmaet, der fremstiller softwaren, er “udgiveren.”

  • Hvis manualen distribueres elektronisk, skal du citere websted, hvorfra det hentes som “kilde.”

  • En undtagelse fra dette er, hvis du i dokumentationen bliver bedt om at henvise til et specifikt værk (for eksempel en forskningsartikel eller et websted) når du citerer en kode. Så skal du følge den specifikke vejledning.

Svar

Ud over @aeismail ” s svar:

  • I mit felt er det almindeligt at henvise til Matlab i teksten “Matlab version XY (The Mathworks, USA)”

  • som @Bitwise kommentarer, videnskabelig FOSS angiver ofte, hvordan man citerer. Så vi henviser f.eks. til R som en normal bog. Rs anbefalede citering inkluderer versionen.

  • Hvis versionen ikke er inkluderet i det anbefalede citat, jeg satte det i notefeltet (Bibtex) – det er R måde at sammensætte sådanne citater 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 der er “sa” normal “offentliggørelse, kombinerer jeg de normale citationsdata med yderligere URL- og versionoplysninger: 

    > 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 gør jeg ikke” t har brug for en ekstra dato, fordi udgivelsesdatoen er inkluderet i versionsnummeret.

  • Jeg har brugt anden FOSS-software, hvor jeg ikke fandt en specifikation, så jeg spurgte udviklingen pers hvordan de vil blive citeret.
    Erfaringen er, at udviklerne normalt er meget glade for denne type spørgsmål.

Skriv et svar

Din e-mailadresse vil ikke blive publiceret. Krævede felter er markeret med *