W ramach mojej pracy licencjackiej zajmuję się tworzeniem oprogramowania (mocking framework dla MATLAB-a). W związku z tym często muszę odwoływać się do dokumentacji oprogramowania – zarówno z MATLABA, jak i oprogramowania, które jest moją inspiracją. Byłoby również miło móc odwołać się do dokumentacji konkretnej funkcji, do której się odnoszę (analogia do odwoływania się do określonej strony w książce). Jednak najczęściej uzyskuję dostęp do tej dokumentacji online i ze swej natury zwykle istnieje tylko w formie elektronicznej, co nie jest zalecane w publikowaniu. Jak dotąd najlepsze, co wymyśliłem, to:
@misc{mockitoFeatures, author = {{\em mockito} developers}, title = {Features and Motivations}, note = {\url{https://code.google.com/p/mockito/wiki/FeaturesAndMotivations}}, urldate = {2013-04-24}, } (ściśle mówiąc ok , to nie jest część oficjalnych dokumentów, ale służy temu samemu celowi: jest to konkretna strona i jest dostępna tylko w Internecie)
Szczegółowe pytania:
- Kto powinien być autorem? W przypadku MATLAB-a to chyba Mathworks czy coś takiego; Myślę, że wymienianie projektów open source jako „programistów xx” to najlepsze, co mogę zrobić.
- Jak mam wspomnieć o wersji? Urldate ogólnie pomaga, ale jeśli mam na myśli konkretnej wersji oprogramowania, gdzie mam umieścić te informacje? W tytule?
- Czy są jakieś „oficjalne” zalecenia dotyczące cytowań MATLABa? MATLAB jest często używany w badaniach, być może istnieje sugerowany sposób zrobienia tego i po prostu mi go brakuje. Reszta pytania nadal dotyczy innego oprogramowania.
Komentarze
- Powiązane (zduplikowane?): academia.stackexchange.com/q/5482/ 102
- Również trochę powiązane: academia.stackexchange.com/questions/8098/…
- projekty open source często podpowiadają, jak cytować, np. matplotlib.org/citing.html
- " Daj z siebie wszystko i nie ' t za bardzo się tym martwisz. " To były oficjalne wskazówki dotyczące zasobów internetowych, zanim Academia zaczęła nadążać za technologią i zdała sobie sprawę, że strony internetowe są interesujące. Jeśli masz coś, co nie ma kategorii, po prostu wybierz inny format, który ma pewne zasady, i dostosuj go najlepiej, jak potrafisz. Jeśli żadne instrukcje nie są jednoznacznie zgodne, większość oceniających wygrywa ' t ukarać Cię za coś, co nie ma jasnych instrukcji / precedensów. Jeśli masz zamiar zostać poddany ocenie / ocenie przez kogoś, kto może udzielić Ci wsparcia z wyprzedzeniem, sprawdź swoje wyniki przed przesłaniem
Odpowiedź
Ogólnie rzecz biorąc, traktowałbym dokumentację oprogramowania w zależności od sposobu jej dystrybucji.
-
Jeśli jest publikowana w formie książkowej, należy ją cytować jako książka. Numer wersji znajduje się w miejscu, w którym należy umieścić wydanie, a firma, która produkuje oprogramowanie, jest „wydawcą”.
-
Jeśli podręcznik jest rozpowszechniany w wersji elektronicznej, należy zacytować strona internetowa, z której została uzyskana jako „źródło”.
-
Wyjątkiem jest sytuacja, gdy w dokumentacji zostaniesz poproszony o odniesienie się do określonej pracy (na przykład artykułu badawczego lub witrynę internetową) podczas cytowania kodu. Następnie należy postępować zgodnie z podanymi wskazówkami.
Odpowiedź
Oprócz @aeismail ” Odpowiedź:
- W mojej dziedzinie często odwołuje się do Matlaba w tekście „Wersja Matlab XY (The Mathworks, USA)”
-
jako @Bitwise komentarzy, naukowy FOSS często określa sposób cytowania. Dlatego np. odnosimy się do R jak do zwykłej książki. Zalecane cytowanie R obejmuje wersję.
-
Jeśli wersja nie jest zawarta w zalecany cytat, umieściłem go w polu notatki (Bibtex) – to jest R sposób tworzenia takich cytatów:
> 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}, } -
Jeśli istnieje „normalna” publikacja, łączę zwykłe dane cytowania z dodatkowymi informacjami o adresie URL i wersji:
> 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}, }(Tutaj nie „ Nie potrzebuję dodatkowej daty, ponieważ data wydania jest zawarta w numerze wersji.
-
Używałem innego oprogramowania FOSS, w którym nie znalazłem specyfikacji, więc zapytałem develo pers, jak chcą być cytowani.
Doświadczenie jest takie, że programiści zazwyczaj są bardzo zadowoleni z tego rodzaju pytań.