Jako svou bakalářskou práci vyvíjím nějaký software (posměšný rámec pro MATLAB). Proto často potřebuji odkazovat na dokumentaci k softwaru – jak z MATLABu, tak ze softwaru, který mi slouží jako inspirace. Také by bylo hezké mít možnost odkazovat na dokumentaci konkrétní funkce, na kterou odkazuji (analogie odkazování na konkrétní stránku v knize). Většinou však k této dokumentaci přistupuji online a ze své podstaty má tendenci existovat pouze v elektronické podobě, což se ve zveřejňování nedoporučuje. Zatím nejlepší, co jsem přišel, je toto:
@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 přísně vzato) , toto není součástí oficiálních dokumentů, ale slouží ke stejnému účelu: je to specifická stránka a je k dispozici pouze online)
Specifické otázky:
- Kdo by měl být autorem? V případě MATLABu myslím, že je to Mathworks nebo tak nějak; Myslím, že uvedení open-source projektů jako „vývojářů xx“ je to nejlepší, co mohu udělat.
- Jak mám zmínit verzi? Urldate obecně pomáhá, ale pokud odkazuji na konkrétní verzi softwaru, kam mám tyto informace uvést? V názvu?
- Existují nějaká „oficiální“ doporučení citace MATLAB? MATLAB se hodně používá ve výzkumu, možná existuje navrhovaný způsob, jak to udělat, a chybí mi to. Zbývající otázka však stále platí pro jiný software.
Komentáře
- Související (duplikát?): academia.stackexchange.com/q/5482/ 102
- Trochu související: academia.stackexchange.com/questions/8098/…
- open source projekty vám často říkají, jak citovat, např. matplotlib.org/citing.html
- " Snažte se a nedělejte ' t příliš se o to starejte. " Jednalo se o oficiální pokyny poskytované o internetových zdrojích, než Academia začala dohánět technologii a uvědomit si, že webové stránky jsou zajímavé. Pokud máte něco, co nemá žádnou kategorii, jednoduše si vyberte jiný formát, který má určitá pravidla, a přizpůsobte se co nejlépe. Pokud se žádné pokyny jasně neshodují, většina srovnávačů vás ' nebude penalizovat za něco, co nemá jasné pokyny / precedens. Pokud vás bude hodnotit / hodnotit někdo, kdo vám může poskytnout podporu předem, zkontrolujte své výsledky před odesláním
Odpovědět
Obecně bych zacházel s dokumentací softwaru podle toho, jak je distribuována.
-
Pokud je publikována v knižní podobě, měla by být citována jako kniha. Číslo verze je určeno tam, kam byste vydání umístili, a společnost, která software vyrábí, je „vydavatelem“.
-
Pokud je příručka distribuována elektronicky, měli byste uvést web, ze kterého je získáván jako „zdroj“.
-
Výjimkou je, pokud budete v dokumentaci požádáni o odkaz na konkrétní práci (například výzkumný článek nebo webové stránky), když citujete kód. Pak byste měli postupovat podle konkrétních pokynů.
Odpovědět
Kromě @aeismail “ s odpověď:
- V mém oboru je běžné odkazovat na Matlab v textu „Matlab verze XY (The Mathworks, USA)“
-
jako @Bitwise komentáře, vědecké FOSS často specifikuje, jak citovat. Takže odkazujeme např. na R jako na běžnou knihu. Doporučená citace R zahrnuje verzi.
-
Pokud verze není zahrnuta v doporučená citace, vložil jsem ji do pole poznámky (Bibtex) – to je R způsob, jak dát dohromady takové citace:
> 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}, } -
Pokud existuje „normální“ publikace, zkombinuji údaje o běžných citacích s dalšími informacemi o adrese URL a verzi:
> 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}, }(Tady, ne) Nepotřebuji další datum, protože datum vydání je zahrnuto v čísle verze.
-
Používám jiný software FOSS, kde jsem nenašel specifikaci, tak jsem se zeptal vývoj jak chtějí být citováni.
Zkušenost je taková, že vývojáři mají z tohoto druhu otázek obvykle velkou radost.