Crowd cookbooks: usando conhecimento de multidão a partir de sítios de perguntas e respostas para documentação de apis
Ano de defesa: | 2014 |
---|---|
Autor(a) principal: | |
Orientador(a): | |
Banca de defesa: | , |
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 |