Como tesis de mi licenciatura, estoy desarrollando un software (un marco burlón para MATLAB). Como tal, a menudo necesito hacer referencia a la documentación del software, tanto de MATLAB como del software que me sirve de inspiración. También sería bueno poder hacer referencia a la documentación de la característica específica a la que me refiero (el análogo de hacer referencia a una página específica en un libro). Sin embargo, accedo principalmente a esta documentación en línea y, por su naturaleza, tiende a existir solo en formato electrónico, lo cual no se recomienda en la publicación. Hasta ahora, lo mejor que he encontrado es esto: 

@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 estrictamente hablando , esto no es parte de los documentos oficiales pero tiene el mismo propósito: es una página específica y solo está disponible en línea)

Preguntas específicas:

  • ¿Quién debería ser el autor? En el caso de MATLAB, supongo que es Mathworks o algo así; Supongo que enumerar proyectos de código abierto como «xx desarrolladores» es lo mejor que puedo hacer.
  • ¿Cómo debo mencionar la versión? Urldate ayuda en general, pero si me refiero a una versión de software en particular, ¿dónde debería poner esta información? ¿En el título?
  • ¿Hay alguna recomendación «oficial» de citas de MATLAB? MATLAB se usa mucho en la investigación, tal vez haya una forma sugerida de hacerlo y me la estoy perdiendo. Sin embargo, el resto de la pregunta todavía se aplica a otro software.

Comentarios

  • Relacionados (¿duplicado?): academia.stackexchange.com/q/5482/ 102
  • También algo relacionado: academia.stackexchange.com/questions/8098/…
  • Los proyectos de código abierto a menudo le dicen cómo citar, por ejemplo, matplotlib.org/citing.html
  • » Haz tu mejor esfuerzo y no ‘ t Preocuparse demasiado por eso. » Estas fueron las instrucciones oficiales proporcionadas sobre los recursos de Internet antes de que la Academia comenzara a ponerse al día con la tecnología y se diera cuenta de que los sitios web eran interesantes. Si tiene algo que no tiene categoría, simplemente elija otro formato que sí tenga algunas reglas y adáptelo lo mejor que pueda. Si ninguna instrucción coincide claramente, la mayoría de los calificadores ‘ t no lo penalizarán por algo que no tenga instrucciones claras o precedentes. Si va a ser juzgado / calificado por alguien que pueda brindarle apoyo con anticipación, verifique sus resultados antes de enviarlos

Responder

En general, trataría la documentación de software dependiendo de cómo esté distribuida.

  • Si se publica en forma de libro, entonces debería citarse como un libro. El número de versión va donde colocaría la edición y la empresa que fabrica el software es el «editor».

  • Si el manual se distribuye electrónicamente, debe citar el sitio web del que se obtiene como «fuente».

  • Una excepción a esto es si se le pide en la documentación que haga referencia a un trabajo específico (por ejemplo, un artículo de investigación , o un sitio web) al citar un código. Luego, debe seguir la guía específica proporcionada.

Responder

Además de @aeismail » s respuesta:

  • En mi campo, es común referirse a Matlab en el texto «Matlab versión XY (The Mathworks, EE. UU.)»

  • como @Bitwise comentarios, el software libre científico a menudo especifica cómo se cita. Por lo tanto, nos referimos, por ejemplo, a R como un libro normal. La cita recomendada de R incluye la versión.

  • Si la versión no está incluida en la cita recomendada, la puse en el campo de nota (Bibtex) – esa es la forma R de juntar dichas citas: 

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

  • Si hay una publicación «normal», combino los datos de citas normales con información adicional sobre la versión y la URL: 

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

    (Aquí, no » No necesito una fecha adicional, porque la fecha de lanzamiento está incluida en el número de versión.

  • He estado usando otro software FOSS en el que no encontré una especificación, así que pregunté el desarrollo pers cómo quieren que se les cite.
    La experiencia es que los desarrolladores suelen estar muy contentos con este tipo de preguntas.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *