Als bachelorscriptie ben ik wat software aan het ontwikkelen (een spottend raamwerk voor MATLAB). Als zodanig moet ik vaak naar softwaredocumentatie verwijzen – zowel van MATLAB als de software die als mijn inspiratie dient. Het zou ook leuk zijn om te kunnen verwijzen naar de documentatie van het specifieke kenmerk waarnaar ik verwijs (het analoog van het verwijzen naar een specifieke pagina in een boek). Ik heb echter meestal toegang tot deze documentatie online en van nature heeft het de neiging om te bestaan alleen in elektronische vorm, wat niet echt wordt aanbevolen bij het publiceren. Tot nu toe is dit het beste wat ik heb bedacht: 

@misc{mockitoFeatures, author = {{\em mockito} developers}, title = {Features and Motivations}, note = {\url{https://code.google.com/p/mockito/wiki/FeaturesAndMotivations}}, urldate = {2013-04-24}, }

(strikt genomen oké , dit maakt geen deel uit van de officiële documenten, maar het dient hetzelfde doel: het is een specifieke pagina en is alleen online beschikbaar)

Specifieke vragen:

  • Wie zou de auteur moeten zijn? In het geval van MATLAB denk ik dat het Mathworks is of zoiets; Ik denk dat het vermelden van open-sourceprojecten als “xx developers” het beste is wat ik kan doen.
  • Hoe moet ik de versie noemen? Urldate helpt in het algemeen, maar als ik verwijs naar een bepaalde softwareversie, waar moet ik deze informatie plaatsen? In de titel?
  • Zijn er “officiële” MATLAB-citatieaanbevelingen? MATLAB wordt veel gebruikt in onderzoek, misschien is er” een voorgestelde manier om het te doen en mis ik het gewoon. De rest van de vraag is nog steeds van toepassing op andere software.

Opmerkingen

  • Gerelateerd (duplicaat?): academia.stackexchange.com/q/5482/ 102
  • Ook enigszins gerelateerd: academia.stackexchange.com/questions/8098/…
  • open source-projecten vertellen je vaak hoe je moet citeren, bijv. matplotlib.org/citing.html
  • ” Doe je best, en ‘ t maak je er teveel zorgen over. ” Dit waren officiële aanwijzingen over internetbronnen voordat Academia technologie begon in te halen en besefte dat websites interessant waren. Als je iets hebt dat geen categorie heeft, kies dan gewoon een ander formaat dat wel een aantal regels heeft, en pas je zo goed mogelijk aan. Als er geen duidelijke instructies zijn, zullen de meeste beoordelaars ‘ u niet straffen voor iets dat geen duidelijke instructies / precedent heeft. Als u wordt beoordeeld / beoordeeld door iemand die u van tevoren ondersteuning kan bieden, controleer dan uw resultaten voordat u deze indient.

Antwoord

In het algemeen zou ik softwaredocumentatie behandelen afhankelijk van hoe het wordt verspreid.

  • Als het in boekvorm is gepubliceerd, moet het worden geciteerd als een boek. Het versienummer gaat naar de plaats waar u de editie zou plaatsen en het bedrijf dat de software vervaardigt, is de “uitgever”.

  • Als de handleiding elektronisch wordt verspreid, moet u de website waarvan het is verkregen als de “bron”.

  • Een uitzondering hierop is als u in de documentatie wordt gevraagd naar een specifiek werk (bijvoorbeeld een onderzoeksartikel , of een website) bij het citeren van een code. Dan moet u de gegeven richtlijnen volgen.

Antwoord

Naast @aeismail ” s antwoord:

  • In mijn vak is het gebruikelijk om naar Matlab te verwijzen in de tekst “Matlab versie XY (The Mathworks, VS)”

  • als @Bitwise commentaren, specificeert wetenschappelijke FOSS vaak hoe citeren. Daarom verwijzen we bijvoorbeeld naar R als een normaal boek. De aanbevolen verwijzing van R omvat de versie.

  • Als de versie niet is opgenomen in het aanbevolen citaat, ik stopte het in het notitieveld (Bibtex) – dat “is de R-manier om dergelijke citaten samen te stellen: 

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

  • Als er “een” normale “publicatie is, combineer ik de normale citatiegegevens met aanvullende URL- en versiegegevens: 

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

    (Hier, ik don” ik heb geen extra datum nodig, omdat de releasedatum is opgenomen in het versienummer.

  • Ik heb andere FOSS-software gebruikt waarvoor ik geen specificatie kon vinden, dus ik vroeg de develo pers hoe ze geciteerd willen worden.
    De ervaring is dat de ontwikkelaars meestal erg blij zijn met dit soort vragen.

Geef een reactie

Het e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *