Como minha tese de bacharelado, estou desenvolvendo um software (uma estrutura de simulação para MATLAB). Como tal, geralmente preciso consultar a documentação do software – tanto do MATLAB quanto do software que me serve de inspiração. Também seria bom poder consultar a documentação do recurso específico a que estou me referindo (o análogo de fazer referência a uma página específica em um livro). No entanto, eu acesso essa documentação principalmente online e por sua natureza ela tende a existir apenas em formato eletrônico, o que não é realmente recomendado para publicação. Até agora, o melhor que descobri é este:
@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 falando estritamente , isso não faz parte dos documentos oficiais, mas tem o mesmo propósito: é uma página específica e está disponível apenas online)
Perguntas específicas:
- Quem deve ser o autor? No caso do MATLAB, acho que é Mathworks ou algo assim; Acho que listar projetos de código aberto como “desenvolvedores xx” é o melhor que posso fazer.
- Como devo mencionar a versão? Urldate ajuda em geral, mas se estou me referindo a uma versão de software específica, onde devo colocar essas informações? No título?
- Há alguma recomendação “oficial” de citação do MATLAB? O MATLAB é muito usado em pesquisas, talvez haja uma maneira sugerida de fazê-lo e eu esteja simplesmente perdendo. O resto da questão ainda se aplica a outros softwares.
Comentários
- Relacionado (duplicado?): academia.stackexchange.com/q/5482/ 102
- Também um tanto relacionado: academia.stackexchange.com/questions/8098/…
- projetos de código aberto muitas vezes dizem a você como citar, por exemplo, matplotlib.org/citing.html
- ” Faça o seu melhor e não ‘ t se preocupe muito com isso. ” Essas foram as instruções oficiais fornecidas sobre os recursos da Internet antes que a Academia começasse a se atualizar com a tecnologia e perceber que os sites eram interessantes. Se você tem algo que não tem categoria, simplesmente escolha outro formato que tenha algumas regras e se adapte da melhor maneira possível. Se nenhuma instrução corresponder claramente, a maioria dos avaliadores ganhará ‘ t penalizá-lo por algo que não tem instruções / precedentes claros. Se você vai ser julgado / avaliado por alguém que pode lhe fornecer suporte com antecedência, verifique seus resultados antes do envio.
Resposta
Em geral, eu trataria a documentação do software dependendo de como ela é distribuída.
-
Se for publicado na forma de livro, deve ser citado como um livro. O número da versão indica onde você colocaria a edição, e a empresa que fabrica o software é o “editor”.
-
Se o manual for distribuído eletronicamente, você deve citar o site do qual é obtido como a “fonte”.
-
Uma exceção a isso é se você for solicitado na documentação para fazer referência a um trabalho específico (por exemplo, um artigo de pesquisa , ou um site) ao citar um código. Então você deve seguir a orientação específica fornecida.
Resposta
Além de @aeismail ” resposta s:
- Na minha área é comum referir-se ao Matlab no texto “Matlab versão XY (The Mathworks, EUA)”
-
como @Bitwise comentários, o FOSS científico geralmente especifica como citar. Portanto, nos referimos, por exemplo, a R como um livro normal. A citação recomendada de R inclui a versão.
-
Se a versão não estiver incluída em a citação recomendada, coloco-a no campo de notas (Bibtex) – essa é a maneira R de reunir essas citações:
> 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}, } -
Se houver uma publicação “normal”, eu combino os dados de citação normal com informações adicionais de URL e versão:
> 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}, }(Aqui, eu não ” Não preciso de uma data adicional, porque a data de lançamento está incluída no número da versão.
-
Tenho usado outro software FOSS onde não encontrei uma especificação, então perguntei o desenvolvimento pessoas como eles querem ser citados.
A experiência é que os desenvolvedores geralmente ficam muito felizes com esse tipo de pergunta.