Som min kandidatexamen utvecklar jag lite programvara (ett hånfullt ramverk för MATLAB). Som sådan behöver jag ofta referera till programdokumentation – både från MATLAB och programvaran som fungerar som min inspiration. Det skulle också vara trevligt att kunna hänvisa till dokumentationen för den specifika funktionen jag hänvisar till (analogen att hänvisa till en viss sida i en bok). Jag har dock mest tillgång till denna dokumentation online och av sin natur tenderar den att existera bara i elektronisk form, vilket inte riktigt rekommenderas vid publicering. Hittills är det bästa jag har kommit fram till: 

@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 strängt taget , detta är inte en del av det officiella dokumentet men det tjänar samma syfte: det är en specifik sida och det är bara tillgängligt online)

Specifika frågor:

  • Vem ska vara författare? När det gäller MATLAB antar jag att det är Mathworks eller någon sådan; Jag antar att det är det bästa jag kan göra att öppna källkodsprojekt som ”xx-utvecklare”.
  • Hur ska jag nämna versionen? Urldate hjälper i allmänhet, men om jag hänvisar till en viss programversion, var ska jag lägga den här informationen? I titeln?
  • Finns det några ”officiella” MATLAB-citatrekommendationer? MATLAB används mycket i forskning, kanske finns det ett föreslaget sätt att göra det och jag saknar det bara. Resten av frågan gäller dock fortfarande för annan programvara.

Kommentarer

  • Relaterade (duplikat?): academia.stackexchange.com/q/5482/ 102
  • Också något relaterat: academia.stackexchange.com/questions/8098/…
  • öppen källkodsprojekt berättar ofta för dig hur du citerar, t.ex. matplotlib.org/citing.html
  • " Gör ditt bästa och gör ' t oroa dig för mycket. " Detta var officiella anvisningar om Internetresurser innan Academia började komma ikapp med tekniken och inser att webbplatser var intressanta. Om du har något som inte har någon kategori, välj bara ett annat format som har vissa regler och anpassa dig så bra du kan. Om inga instruktioner tydligt stämmer, kommer de flesta klassare att ' inte straffa dig för något som inte har några tydliga instruktioner / prejudikat. Om du kommer att bedömas / betygsättas av någon som kan ge dig stöd i förväg, kolla dina resultat innan du lämnar in

Svar

I allmänhet skulle jag behandla programvarudokumentation beroende på hur den distribueras.

  • Om den publiceras i bokform bör den citeras som en bok. Versionsnumret går dit du skulle lägga utgåvan, och företaget som tillverkar programvaran är ”utgivare”.

  • Om handboken distribueras elektroniskt bör du citera webbplats från vilken den erhålls som ”källa”.

  • Ett undantag från detta är om du i dokumentationen ombeds hänvisa till ett visst arbete (till exempel en forskningsartikel eller en webbplats) när du citerar en kod. Sedan bör du följa den specifika vägledning som ges.

Svar

Förutom @aeismail ” s svar:

  • I mitt fält är det vanligt att hänvisa till Matlab i texten ”Matlab version XY (The Mathworks, USA)”

  • som @Bitwise kommentarer, vetenskaplig FOSS specificerar ofta hur man citerar. Så vi hänvisar t.ex. till R som en vanlig bok. R: s rekommenderade citering inkluderar versionen.

  • Om versionen inte ingår i det rekommenderade citatet, jag lade det i anteckningsfältet (Bibtex) – det är R-sättet att sätta ihop sådana citat: 

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

  • Om det är ”sa” normal ”publicering, kombinerar jag den normala citatdata med ytterligare webbadress och versioninformation: 

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

    (Här gör jag inte” t behöver ett ytterligare datum, eftersom släppdatumet ingår i versionsnumret.

  • Jag har använt annan FOSS-programvara där jag inte hittade en specifikation, så jag frågade utvecklingen pers hur de vill citeras.
    Erfarenheten är att utvecklarna vanligtvis är mycket glada över denna typ av frågor.

Lämna ett svar

Din e-postadress kommer inte publiceras. Obligatoriska fält är märkta *