AK-finder - Architectural Knowledge Finder - Querying Architectural Knowledge as Linked Open Data
Switch branches/tags
Nothing to show
Clone or download
kadevgraaf
kadevgraaf Updated interfaces
Latest commit f9a92c1 Feb 21, 2017

README.md

AK-Finder - Architectural Knowledge Finder

Intro

The AK-Finder tool sends queries to a SPARQL query endpoint of a semantic wiki (ArchiMind currently, see below and https://github.com/kadevgraaf/ArchiMind ). The SPARQL queries retrieve architectural knowledge to support design and development activities and answer questions from an approach for architecture documentation review by the SEI. The AK-Finder tool exemplifies retrieval of architectural knowledge as Linked Open Data, and can be freely adapted/reused under the GPL license.

See Demo on http://softcode.nl/AK-finder/index.php

Archimind is a semantic wiki for Software Architecture (SA) documentation management and retrieval and was adapted from [OntoWiki] (http://aksw.org/Projects/OntoWiki.html) version 0.9.5. A concise overview of (part of the) adaptations and their rationale is given in paper Klaas Andries de Graaf - "Annotating Software Documentation in Semantic Wikis. See below for more references. [https://github.com/AKSW/OntoWiki/wiki] provides detailed installation instructions for OntoWiki. These instructions also apply to the installation of ArchiMind. OntoWiki 1.0.0 has been release recently - this release provides a SQARQL Query endpoint and is probably better for user experience, however, the ArchiMind adaptations for Software Architecture (SA) documentation management and retrieval are not yet implemented in this version (only 0.9.5 currently).

Requirements

PHP

License

AK-Finder is licensed under the GNU General Public License Version 2, June 1991.

Code snippets adapted from http://graphite.ecs.soton.ac.uk/sparqllib/

Use of sparqllib.php ©2010-12 Christopher Gutteridge, University of Southampton. Under LGPL license

references

OntoWiki:

http://aksw.org/Projects/OntoWiki.html

http://ontowiki.net/

https://github.com/AKSW/OntoWiki

https://github.com/AKSW/OntoWiki/releases

ArchiMind:

https://github.com/kadevgraaf/ - http://kadegraaf.nl/

Klaas Andries de Graaf - "Annotating Software Documentation in Semantic Wikis" - In Proceedings of the fourth workshop on Exploiting semantic annotations in information retrieval (ESAIR '11), pages 5-6., ACM, 2011.

My PhD Thesis - "Ontology-based Software Architecture Documentation"

Klaas Andries de Graaf, Peng Liang, Antony Tang, Hans van Vliet - "How Organisation of Architecture Documentation Affects Architectural Knowledge Retrieval" - Science of Computer Programming, Volume 121, Pages 75-99 Elsevier, June 2016.

Klaas Andries de Graaf, Peng Liang, Antony Tang, Hans van Vliet - "Supporting Architecture Documentation: A Comparison of Two Ontologies for Knowledge Retrieval" - In International Conference on Evaluation and Assessment in Software Engineering (EASE), pages 3:1--3:10, ACM, 2015.

Klaas Andries de Graaf, Peng Liang, Antony Tang, Hans van Vliet - "The Impact of Prior Knowledge on Searching in Software Documentation" - In Proceedings of the 2014 ACM symposium on Document engineering (DocEng), pages 189-198, ACM, 2014.

Klaas Andries de Graaf, Peng Liang, Antony Tang, Willem van Hage, Hans van Vliet - "An Exploratory Study on Ontology Engineering for Software Architecture Documentation" - Computers in Industry, Vol. 65, nr. 7, pages 1053-1064, Elsevier, 2014.

Klaas Andries de Graaf, Antony Tang, Peng Liang, Hans van Vliet - "Ontology-based Software Architecture Documentation" - In Proceedings of the Joint 10th Working IEEE/IFIP Conference on Software Architecture & 6th European Conference on Software Architecture (WICSA/ECSA), pages 121-130, IEEE Computer Society, 2012.