kaiaulu

Kaiāulu

Kai.ā.ulu n.

1. Communauté, quartier, village. ʻOia nō kekahi o nā kānaka waiwai nui a kūʻonoʻono ma iā Mau kaiāulu, il était l'une des personnes les plus riches et les plus prospères de ces communautés.

Aperçu

Kaiaulu est un package R et une interface commune qui aide à comprendre les communautés de développement de logiciels en évolution, et les artefacts (gitlog, liste de diffusion, fichiers, etc.) sur lesquels les développeurs collaborent et communiquent. Vous pouvez en savoir plus sur la motivation et l'architecture de Kaiaulu dans la pré-imprimée de notre article.

Pour des fonctionnalités détaillées, voir l'API de Kaiaulu.

Veuillez poser des questions sur les discussions ou ouvrir un problème sur le tracker du problème si vous avez trouvé un bogue, ou si votre réponse ne peut être trouvée dans la documentation. Une liste de fonctionnalités plus complète et en pleine croissance est disponible sur le Wiki du projet.

Installation

Kaiaulu a été testé sur OS X et Ubuntu. Pour les utilisateurs de Windows et d'autres SO, essayez VirtualBox, VMware ou tout autre logiciel pour exécuter des machines virtuelles pour Ubuntu.

Vous pouvez installer Kaiaulu en utilisant la commande suivante dans votre console R:

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

Je vous recommande également de télécharger le dépôt pour avoir des exemples de fichiers de configuration de projet et de cahiers pour expérimenter:

1. Cloner ce repo
2. Ouvrir kaiaulu.Rproj en utilisant rstudio
3. Exécutez l'unité Tests devtools::test() . En cas d'échec, et vous n'êtes pas clair pourquoi, n'hésitez pas à demander dans des discussions
4. Construisez la documentation devtools::document(roclets = c('rd', 'collate', 'namespace')) .
5. Build Kaiaulu (volet en haut à droite dans RStudio -> Build Tab -> Installer et redémarrer)
6. Exécutez vignettes/kaiaulu_architecture.Rmd
7. Voir la configuration des outils tiers du wiki si vous utilisez un ordinateur portable qui s'appuie sur eux. Ceux-ci nécessitent des frais généraux très minimes en téléchargeant un fichier binaire et en spécifiant leur chemin sur tools.yml (voir l'exemple sur le référentiel).

Commencer

Pour commencer, parcourez les documents.

Insignes

Odeurs sociales	Défauts architecturaux

Rester à jour

• Lisez le fichier d'actualités.

Contributif

• Voir le dossier contribuant pour les questions, les problèmes et les demandes de traction contribuant.

Comment citer Kaiaulu

Si vous utilisez Kaiaulu dans vos recherches, veuillez citer les travaux suivants:

 @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"
}

Pour une liste des travaux antérieurs qui utilisaient Kaiaulu, voir vignettes/kaiaulu_case_studies.Rmd . Si c'est vous, n'hésitez pas à envoyer une demande de traction modifiant le cahier avec votre travail et, si possible, incluez un enregistrement Bibtex.