XINFORMAÇÕES SOBRE DIREITOS AUTORAIS
As obras disponibilizadas nesta Biblioteca Digital foram publicadas sob expressa autorização dos respectivos autores, em conformidade com a Lei 9610/98.
A consulta aos textos, permitida por seus respectivos autores, é livre, bem como a impressão de trechos ou de um exemplar completo exclusivamente para uso próprio. Não são permitidas a impressão e a reprodução de obras completas com qualquer outra finalidade que não o uso próprio de quem imprime.
A reprodução de pequenos trechos, na forma de citações em trabalhos de terceiros que não o próprio autor do texto consultado,é permitida, na medida justificada para a compreeensão da citação e mediante a informação, junto à citação, do nome do autor do texto original, bem como da fonte da pesquisa.
A violação de direitos autorais é passível de sanções civis e penais.
As obras disponibilizadas nesta Biblioteca Digital foram publicadas sob expressa autorização dos respectivos autores, em conformidade com a Lei 9610/98.
A consulta aos textos, permitida por seus respectivos autores, é livre, bem como a impressão de trechos ou de um exemplar completo exclusivamente para uso próprio. Não são permitidas a impressão e a reprodução de obras completas com qualquer outra finalidade que não o uso próprio de quem imprime.
A reprodução de pequenos trechos, na forma de citações em trabalhos de terceiros que não o próprio autor do texto consultado,é permitida, na medida justificada para a compreeensão da citação e mediante a informação, junto à citação, do nome do autor do texto original, bem como da fonte da pesquisa.
A violação de direitos autorais é passível de sanções civis e penais.
Coleção Digital
Título: PROMOTING CONVERSATIONAL APIS: A CONCEPTUAL FRAMEWORK AND A METHOD FOR API DESIGN Autor: JOAO ANTONIO DUTRA MARCONDES BASTOS
Instituição: PONTIFÍCIA UNIVERSIDADE CATÓLICA DO RIO DE JANEIRO - PUC-RIO
Colaborador(es):
ALESSANDRO FABRICIO GARCIA - ADVISOR
Nº do Conteudo: 49982
Catalogação: 20/10/2020 Idioma(s): ENGLISH - UNITED STATES
Tipo: TEXT Subtipo: THESIS
Natureza: SCHOLARLY PUBLICATION
Nota: Todos os dados constantes dos documentos são de inteira responsabilidade de seus autores. Os dados utilizados nas descrições dos documentos estão em conformidade com os sistemas da administração da PUC-Rio.
Referência [pt]: https://www.maxwell.vrac.puc-rio.br/colecao.php?strSecao=resultado&nrSeq=49982@1
Referência [en]: https://www.maxwell.vrac.puc-rio.br/colecao.php?strSecao=resultado&nrSeq=49982@2
Referência DOI: https://doi.org/10.17771/PUCRio.acad.49982
Resumo:
Título: PROMOTING CONVERSATIONAL APIS: A CONCEPTUAL FRAMEWORK AND A METHOD FOR API DESIGN Autor: JOAO ANTONIO DUTRA MARCONDES BASTOS
Nº do Conteudo: 49982
Catalogação: 20/10/2020 Idioma(s): ENGLISH - UNITED STATES
Tipo: TEXT Subtipo: THESIS
Natureza: SCHOLARLY PUBLICATION
Nota: Todos os dados constantes dos documentos são de inteira responsabilidade de seus autores. Os dados utilizados nas descrições dos documentos estão em conformidade com os sistemas da administração da PUC-Rio.
Referência [pt]: https://www.maxwell.vrac.puc-rio.br/colecao.php?strSecao=resultado&nrSeq=49982@1
Referência [en]: https://www.maxwell.vrac.puc-rio.br/colecao.php?strSecao=resultado&nrSeq=49982@2
Referência DOI: https://doi.org/10.17771/PUCRio.acad.49982
Resumo:
APIs (application programming interfaces) play a crucial role in software
development. Almost any programmer is often at the position of using thirdparty
APIs. Currently, we find several researches that seek to explore and
understand users interactions with the API from an usability point of view.
However, such studies leave out an important aspect of an API quality of use,
the communicability. Unlike usability, whose definition is associated with ease
of use and learning, communicability is associated with an artifact s ability
to communicate its design logic. An API that lacks communicability can lead
users to misuse and produce bugs in their code. This doctoral thesis addresses
this problem from a Semiotic Engineering perspective. By characterizing an
API as a mediating artifact for communicability, we started our thesis with
the proposal that APIs should be conversational. We diagnosed in our first
study that users, in certain cases, have difficulty in understanding the internal
operating logic of an API just by looking at its interfaces. In this study, we
found that APIs often lack in communicability. While usability is about the
user s ability to learn and use an API, communicability is about the API s
ability to transfer the designer communication to the user, thus exposing its
design rationale. A conversational API is the one that can expose its internal
logic through its interfaces, attending the pragmatic contexts of its users.
From this study, we then set out to define what a conversational API is in
practice and to investigate what methods or technologies would be needed to
assist designers in creating such APIs. In this thesis, we propose a conceptual
framework and a method to support the design of conversational APIs. When
designing an API, the designer has in hands three different ways to send his
message to his user: the source code, the documentation, and the behavior
of the API. Our conceptual framework explores how to characterize and
classify a conversational API according to the three types of messages from the
designer s perspective. Our method of supporting conversational API design,
which was inspired by the results and lessons learned from an action-research
we conducted, consists of three steps. The first step is to help the designer
on identifying who the API users are and their specific conversational needs.
In the second step, the method helps the designer on modeling possible API
conversations with the different mapped users to achieve their goals. Finally,
the method provides a set of guidelines to guide the designer in defining the API
interfaces, including their parameterization. Using this method, we perform a
case study with an API design, which aims at supporting the refactoring of
Java programs. From the API designer s point of view, the method helped him
on creating empathy with his users and better deriving and reflecting upon the
requirements and conversations that the API should provide to the different
user profiles.
Descrição | Arquivo |
COMPLETE |