Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis

Detalhes bibliográficos
Ano de defesa: 2014
Autor(a) principal: Souza, Lucas Batista Leite de lattes
Orientador(a): Maia, Marcelo de Almeida lattes
Banca de defesa: Macêdo, Autran lattes, Valente, Marco Túlio de Oliveira lattes
Tipo de documento: Dissertação
Tipo de acesso: Acesso aberto
Idioma: por
Instituição de defesa: Universidade Federal de Uberlândia
Programa de Pós-Graduação: Programa de Pós-graduação em Ciência da Computação
Departamento: Ciências Exatas e da Terra
País: BR
Palavras-chave em Português:
Palavras-chave em Inglês:
Área do conhecimento CNPq:
Link de acesso: https://repositorio.ufu.br/handle/123456789/12567
https://doi.org/10.14393/ufu.di.2014.351
Resumo: Developers of reusable software elements, such as libraries, usually have the responsibility to provide comprehensive and high quality documentation to enable eective reuse of those elements. The eective reuse of libraries depends upon the quality of the API (Application Program Interface) documentation. Well established libraries typically have comprehensive API documentation, for example in Javadocs. However, they also typically lack examples and explanations, which may dicult the eective reuse of the library. StackOverow.com (SO) is a Question and Answer service directed to issues related to software development. In SO, a developer can post questions related to a programming topic and other members of the site can provide answers to help him/her solve the problem he/she has at hand. Despite of the increasing use of SO by the software development community, the information related to a particular library is spread along the website. Thus, SO still lacks an organization of its crowd knowledge. In this dissertation, we present a semi-automatic approach that organizes the information available on SO in order to build a kind of documentation for APIs, called cookbooks (recipe-oriented books). The cookbooks generated by the approach are called crowd cookbooks. In order to evaluate the proposed approach, cookbooks were generated for three APIs widely used by the software development community: SWT,LINQ and QT. Desired features that cookbooks must meet were identied and a study with human subjects was conducted to assess to what extent the generated cookbook meet those features. Through the study it was also possible to identify what is the perceived usefulness by the subjects in relation to the use of cookbooks in APIs learning. The results showed that the cookbooks built using the proposed strategy, in general, meet the identied features. Furthermore, most human subjects considered that cookbooks do not have an appropriate format to the learning of APIs.
id UFU_fde66b1b7a926c3e74eb5f264e497446
oai_identifier_str oai:repositorio.ufu.br:123456789/12567
network_acronym_str UFU
network_name_str Repositório Institucional da UFU
repository_id_str
spelling 2016-06-22T18:32:30Z2014-12-102016-06-22T18:32:30Z2014-07-23SOUZA, Lucas Batista Leite de. Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis. 2014. 158 f. Dissertação (Mestrado em Ciências Exatas e da Terra) - Universidade Federal de Uberlândia, Uberlândia, 2014. Disponível em: https://doi.org/10.14393/ufu.di.2014.351https://repositorio.ufu.br/handle/123456789/12567https://doi.org/10.14393/ufu.di.2014.351Developers of reusable software elements, such as libraries, usually have the responsibility to provide comprehensive and high quality documentation to enable eective reuse of those elements. The eective reuse of libraries depends upon the quality of the API (Application Program Interface) documentation. Well established libraries typically have comprehensive API documentation, for example in Javadocs. However, they also typically lack examples and explanations, which may dicult the eective reuse of the library. StackOverow.com (SO) is a Question and Answer service directed to issues related to software development. In SO, a developer can post questions related to a programming topic and other members of the site can provide answers to help him/her solve the problem he/she has at hand. Despite of the increasing use of SO by the software development community, the information related to a particular library is spread along the website. Thus, SO still lacks an organization of its crowd knowledge. In this dissertation, we present a semi-automatic approach that organizes the information available on SO in order to build a kind of documentation for APIs, called cookbooks (recipe-oriented books). The cookbooks generated by the approach are called crowd cookbooks. In order to evaluate the proposed approach, cookbooks were generated for three APIs widely used by the software development community: SWT,LINQ and QT. Desired features that cookbooks must meet were identied and a study with human subjects was conducted to assess to what extent the generated cookbook meet those features. Through the study it was also possible to identify what is the perceived usefulness by the subjects in relation to the use of cookbooks in APIs learning. The results showed that the cookbooks built using the proposed strategy, in general, meet the identied features. Furthermore, most human subjects considered that cookbooks do not have an appropriate format to the learning of APIs.Desenvolvedores de elementos reusáveis de software, como as bibliotecas, em geral têm a responsabilidade de disponibilizar documentação abrangente e de alta qualidade para permitir o reuso efetivo desses elementos. O reuso efetivo de bibliotecas depende da qualidade da documentação da API (Interface para Programação de Aplicativos). Bibliotecas bem estabelecidas tipicamente têm documentação abrangente, por exemplo em Javadocs. Porém, essa documentação geralmente carece de exemplos e explicações, o que pode dicultar o reuso efetivo da biblioteca. Stackoverow.com (SO) é um serviço de perguntas e respostas (Q&A) direcionado a questões relacionadas ao desenvolvimento de software. No SO, um desenvolvedor pode postar perguntas relacionadas a um tópico de programação e outros membros do site podem disponibilizar respostas para ajudá-lo a resolver o problema que ele tem em mãos. Apesar da utilização crescente do SO pela comunidade de desenvolvimento de software, a informação relação a um biblioteca está espalhada ao longo do site. Assim, o SO ainda carece de uma organização do crowd knowledge nele contido. Nessa dissertação, será apresentada uma abordagem semi-automatizada que organiza a informação disponível no SO para a construção de um tipo de documentação para APIs, conhecido por cookbooks (livros orientados a receitas). Os cookbooks produzidos pela abordagem proposta são chamados crowd cookbooks. Para avaliar a abordagem proposta foram gerados cookbooks para três APIs amplamente utilizadas pela comunidade de desenvolvimento de software: SWT, LINQ e QT. Foram identicadas características desejáveis de cookbooks e realizado um estudo com sujeitos humanos para entender em que grau os cookbooks construídos atendem a estas características. Por meio estudo também foi possível compreender melhor os pers de uso dos cookbooks mais apropriados em relação ao aprendizado de APIs. Os resultados mostraram que os cookbooks construídos pela estratégia proposta, em geral, atendem às características identicadas. Além disso, a maior parte dos sujeitos humanos considerou que cookbooks não possuem um formato adequado ao aprendizado de APIs.Mestre em Ciência da Computaçãoapplication/pdfporUniversidade Federal de UberlândiaPrograma de Pós-graduação em Ciência da ComputaçãoUFUBRCiências Exatas e da TerraSítios de perguntas e respostasConhecimento da multidãoInterface para programação de aplicativosDocumentação de softwareCrowdsourcingInterfaces de programação de aplicativo (software de computador)Questions and answers sitesCrowd knowledgeApplication programming interface, Software documentationCNPQ::CIENCIAS EXATAS E DA TERRA::CIENCIA DA COMPUTACAOCrowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apisinfo:eu-repo/semantics/publishedVersioninfo:eu-repo/semantics/masterThesisMaia, Marcelo de Almeidahttp://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4791753E8Macêdo, Autranhttp://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4781728E0Valente, Marco Túlio de Oliveirahttp://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4723796J1http://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4207155A0Souza, Lucas Batista Leite de81753063info:eu-repo/semantics/openAccessreponame:Repositório Institucional da UFUinstname:Universidade Federal de Uberlândia (UFU)instacron:UFUTHUMBNAILCrowdCookbooksUsando.pdf.jpgCrowdCookbooksUsando.pdf.jpgGenerated Thumbnailimage/jpeg1305https://repositorio.ufu.br/bitstream/123456789/12567/3/CrowdCookbooksUsando.pdf.jpg2f96b634157ab0386ff4cc2ddafad595MD53ORIGINALCrowdCookbooksUsando.pdfapplication/pdf2206055https://repositorio.ufu.br/bitstream/123456789/12567/1/CrowdCookbooksUsando.pdffcb7e97e81361ed42a82d75bda68cb6cMD51TEXTCrowdCookbooksUsando.pdf.txtCrowdCookbooksUsando.pdf.txtExtracted texttext/plain298158https://repositorio.ufu.br/bitstream/123456789/12567/2/CrowdCookbooksUsando.pdf.txtac2ebaf27830f2f038f15fdcd51c1178MD52123456789/125672021-08-10 11:08:40.122oai:repositorio.ufu.br:123456789/12567Repositório InstitucionalONGhttp://repositorio.ufu.br/oai/requestdiinf@dirbi.ufu.bropendoar:2021-08-10T14:08:40Repositório Institucional da UFU - Universidade Federal de Uberlândia (UFU)false
dc.title.por.fl_str_mv Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
title Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
spellingShingle Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
Souza, Lucas Batista Leite de
Sítios de perguntas e respostas
Conhecimento da multidão
Interface para programação de aplicativos
Documentação de software
Crowdsourcing
Interfaces de programação de aplicativo (software de computador)
Questions and answers sites
Crowd knowledge
Application programming interface, Software documentation
CNPQ::CIENCIAS EXATAS E DA TERRA::CIENCIA DA COMPUTACAO
title_short Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
title_full Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
title_fullStr Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
title_full_unstemmed Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
title_sort Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
author Souza, Lucas Batista Leite de
author_facet Souza, Lucas Batista Leite de
author_role author
dc.contributor.advisor1.fl_str_mv Maia, Marcelo de Almeida
dc.contributor.advisor1Lattes.fl_str_mv http://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4791753E8
dc.contributor.referee1.fl_str_mv Macêdo, Autran
dc.contributor.referee1Lattes.fl_str_mv http://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4781728E0
dc.contributor.referee2.fl_str_mv Valente, Marco Túlio de Oliveira
dc.contributor.referee2Lattes.fl_str_mv http://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4723796J1
dc.contributor.authorLattes.fl_str_mv http://buscatextual.cnpq.br/buscatextual/visualizacv.do?id=K4207155A0
dc.contributor.author.fl_str_mv Souza, Lucas Batista Leite de
contributor_str_mv Maia, Marcelo de Almeida
Macêdo, Autran
Valente, Marco Túlio de Oliveira
dc.subject.por.fl_str_mv Sítios de perguntas e respostas
Conhecimento da multidão
Interface para programação de aplicativos
Documentação de software
Crowdsourcing
Interfaces de programação de aplicativo (software de computador)
topic Sítios de perguntas e respostas
Conhecimento da multidão
Interface para programação de aplicativos
Documentação de software
Crowdsourcing
Interfaces de programação de aplicativo (software de computador)
Questions and answers sites
Crowd knowledge
Application programming interface, Software documentation
CNPQ::CIENCIAS EXATAS E DA TERRA::CIENCIA DA COMPUTACAO
dc.subject.eng.fl_str_mv Questions and answers sites
Crowd knowledge
Application programming interface, Software documentation
dc.subject.cnpq.fl_str_mv CNPQ::CIENCIAS EXATAS E DA TERRA::CIENCIA DA COMPUTACAO
description Developers of reusable software elements, such as libraries, usually have the responsibility to provide comprehensive and high quality documentation to enable eective reuse of those elements. The eective reuse of libraries depends upon the quality of the API (Application Program Interface) documentation. Well established libraries typically have comprehensive API documentation, for example in Javadocs. However, they also typically lack examples and explanations, which may dicult the eective reuse of the library. StackOverow.com (SO) is a Question and Answer service directed to issues related to software development. In SO, a developer can post questions related to a programming topic and other members of the site can provide answers to help him/her solve the problem he/she has at hand. Despite of the increasing use of SO by the software development community, the information related to a particular library is spread along the website. Thus, SO still lacks an organization of its crowd knowledge. In this dissertation, we present a semi-automatic approach that organizes the information available on SO in order to build a kind of documentation for APIs, called cookbooks (recipe-oriented books). The cookbooks generated by the approach are called crowd cookbooks. In order to evaluate the proposed approach, cookbooks were generated for three APIs widely used by the software development community: SWT,LINQ and QT. Desired features that cookbooks must meet were identied and a study with human subjects was conducted to assess to what extent the generated cookbook meet those features. Through the study it was also possible to identify what is the perceived usefulness by the subjects in relation to the use of cookbooks in APIs learning. The results showed that the cookbooks built using the proposed strategy, in general, meet the identied features. Furthermore, most human subjects considered that cookbooks do not have an appropriate format to the learning of APIs.
publishDate 2014
dc.date.available.fl_str_mv 2014-12-10
2016-06-22T18:32:30Z
dc.date.issued.fl_str_mv 2014-07-23
dc.date.accessioned.fl_str_mv 2016-06-22T18:32:30Z
dc.type.status.fl_str_mv info:eu-repo/semantics/publishedVersion
dc.type.driver.fl_str_mv info:eu-repo/semantics/masterThesis
format masterThesis
status_str publishedVersion
dc.identifier.citation.fl_str_mv SOUZA, Lucas Batista Leite de. Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis. 2014. 158 f. Dissertação (Mestrado em Ciências Exatas e da Terra) - Universidade Federal de Uberlândia, Uberlândia, 2014. Disponível em: https://doi.org/10.14393/ufu.di.2014.351
dc.identifier.uri.fl_str_mv https://repositorio.ufu.br/handle/123456789/12567
dc.identifier.doi.por.fl_str_mv https://doi.org/10.14393/ufu.di.2014.351
identifier_str_mv SOUZA, Lucas Batista Leite de. Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis. 2014. 158 f. Dissertação (Mestrado em Ciências Exatas e da Terra) - Universidade Federal de Uberlândia, Uberlândia, 2014. Disponível em: https://doi.org/10.14393/ufu.di.2014.351
url https://repositorio.ufu.br/handle/123456789/12567
https://doi.org/10.14393/ufu.di.2014.351
dc.language.iso.fl_str_mv por
language por
dc.rights.driver.fl_str_mv info:eu-repo/semantics/openAccess
eu_rights_str_mv openAccess
dc.format.none.fl_str_mv application/pdf
dc.publisher.none.fl_str_mv Universidade Federal de Uberlândia
dc.publisher.program.fl_str_mv Programa de Pós-graduação em Ciência da Computação
dc.publisher.initials.fl_str_mv UFU
dc.publisher.country.fl_str_mv BR
dc.publisher.department.fl_str_mv Ciências Exatas e da Terra
publisher.none.fl_str_mv Universidade Federal de Uberlândia
dc.source.none.fl_str_mv reponame:Repositório Institucional da UFU
instname:Universidade Federal de Uberlândia (UFU)
instacron:UFU
instname_str Universidade Federal de Uberlândia (UFU)
instacron_str UFU
institution UFU
reponame_str Repositório Institucional da UFU
collection Repositório Institucional da UFU
bitstream.url.fl_str_mv https://repositorio.ufu.br/bitstream/123456789/12567/3/CrowdCookbooksUsando.pdf.jpg
https://repositorio.ufu.br/bitstream/123456789/12567/1/CrowdCookbooksUsando.pdf
https://repositorio.ufu.br/bitstream/123456789/12567/2/CrowdCookbooksUsando.pdf.txt
bitstream.checksum.fl_str_mv 2f96b634157ab0386ff4cc2ddafad595
fcb7e97e81361ed42a82d75bda68cb6c
ac2ebaf27830f2f038f15fdcd51c1178
bitstream.checksumAlgorithm.fl_str_mv MD5
MD5
MD5
repository.name.fl_str_mv Repositório Institucional da UFU - Universidade Federal de Uberlândia (UFU)
repository.mail.fl_str_mv diinf@dirbi.ufu.br
_version_ 1792331414373400576