kaiaulu

Kaiāulu

kai.ā.ulu n.

1. Comunidade, bairro, vila. ʻOia nō kekahi o nā kānaka waiwai nui a kūʻonoʻono ma iā mau kaiāulu, ele era uma das pessoas mais ricas e prósperas dessas comunidades.

Visão geral

O Kaiaulu é um pacote R e uma interface comum que ajuda a entender as comunidades de desenvolvimento de software em evolução e os artefatos (GitLog, Lista de correspondência, arquivos etc.) que os desenvolvedores colaboram e se comunicam. Você pode ler mais motivação e arquitetura de Kaiaulu na pré-impressão de nosso artigo.

Para funcionalidade detalhada, consulte a API de Kaiaulu.

Faça perguntas sobre discussões ou abra um problema no rastreador de questões se você encontrou um bug, ou sua resposta não pode ser encontrada na documentação. Uma lista mais abrangente e crescente de recursos está disponível no Wiki do projeto.

Instalação

Kaiaulu foi testado no OS X e Ubuntu. Para Windows e outros usuários do sistema operacional, experimente o VirtualBox, o VMware ou qualquer outro software para executar máquinas virtuais para o Ubuntu.

Você pode instalar o Kaiaulu usando o seguinte comando em seu console R:

 if (!require("devtools")) install.packages("devtools")
devtools::install_github("sailuh/kaiaulu")

Eu também recomendo que você faça o download do repositório para ter alguns exemplos de arquivos de configuração do projeto e notebooks para experimentar:

1. Clone este repo
2. Abrir kaiaulu.Rproj usando rstudio
3. Execute os testes de unidade devtools::test() . Se falhar, e você não estiver claro o porquê, sinta -se à vontade para perguntar nas discussões
4. Crie a documentação devtools::document(roclets = c('rd', 'collate', 'namespace')) .
5. Construa Kaiaulu (painel superior direito em RStudio -> Build Tab -> Instale e reinicie)
6. Execute vignettes/kaiaulu_architecture.Rmd
7. Veja a configuração de ferramentas de terceiros do Wiki se você estiver usando um notebook que se baseia nelas. Isso requer uma sobrecarga muito mínima, baixando um arquivo binário e especificando seu caminho em tools.yml (consulte o exemplo no repositório).

Começando

Para começar, navegue pelos documentos.

Cheatsheets

Cheiros sociais	Falhas arquitetônicas

Fique atualizado

• Leia o arquivo de notícias.

Contribuindo

• Consulte o arquivo contribuinte para obter perguntas, questões e solicitações de puxar contribuintes.

Como citar Kaiaulu

Se você estiver usando o Kaiaulu em sua pesquisa, cite o seguinte trabalho:

 @InProceedings{Paradis:2022,
author="Paradis, Carlos and Kazman, Rick",
editor="Scandurra, Patrizia and Galster, Matthias and Mirandola, Raffaela and Weyns, Danny",
title="Building the MSR Tool Kaiaulu: Design Principles and Experiences",
booktitle="Software Architecture",
year="2022",
publisher="Springer International Publishing",
address="Cham",
pages="107--129",
isbn="978-3-031-15116-3",
doi = "10.1007/978-3-031-15116-3_6"
}

Para uma lista de trabalhos anteriores que usavam kaiaulu, consulte vignettes/kaiaulu_case_studies.Rmd . Se for você, sinta -se à vontade para enviar uma solicitação de tração modificando o notebook com seu trabalho e, se possível, inclua um registro do Bibtex.