Welcome to the first milestone of the Fedora API Extensions (API-X) framework. This milestone is the first concrete implementation of API-X, and is accompanied by a set of evaluation tasks comprising a demo that showcases its current capabilities and serves as a basis for soliciting feedback from the community.
The API-X milestone demo uses the docker environment to package pre-configured instances of Fedora, API-X, and services into lightweight "containers" that behave much as if they were deployed in separate virtual machines. docker-compose is used to run the demo on an evaluator's local machine. Using docker-compose, the demo environment can be created, paused/resumed, or wiped clean at any point.
Please provide general feedback or questions on the demo in the form of comments on this page.
Bugs and/or feature requests can be submitted on github. We will try to fix any bugs affecting the demo as soon as possible, and incorporate fixes into the docker images so that they can be pulled into your demo environment as soon as they are available. Feature or improvement requests on github are especially welcome.
When performing the evaluation tasks, please keep the following questions in mind when formulating feedback
- Do any aspects of API-X seem particularly useful or not useful for your own use cases?
- Was any step particularly difficult or burdensome, or surprisingly easy? Do you have any suggestions for improvement?
- Do you feel any particular topic should be explored in greater depth in a future milestone demo/evaluation?
- Do you have any unanswered questions?
To participate in the demo, please:
- Install the requirements (e.g. Docker and curl) if not already present
- Read the getting started guide for using docker-compose to start Fedora, API-X and surrounding services
- Verify that the demo has started successfully
- Read running the evaluation before you start for some helpful information to make the process go smoothly.
Once everything is up and running, you can start working through the evaluation tasks. Most (but not all) current API-X features are encountered in one form or another. The tasks do not have to be done linearly, and they do not have to be done all at once.
- Resources, URIs, and Proxies
- Service Documents
- Interacting with exposed services
- Loading and deploying extensions
- Ontologies and Binding
We need participants!
If anyone is interested in evaluating the demo, feel free to place your name as an participant on this page, or just get started and provide feedback when inspired. We are asking participants to 1) provide feedback on the content of the evaluation tasks and guide (e.g. are there tasks we are missing?) and 2) download the demo and execute the tasks, and provide feedback on the experience.
People who have helped participate in the creation or evaluation of the demo include:
- Elliot Metsger - Johns Hopkins, Software Engineer, API-X stakeholder and developer
- Ruth Duerr - Ronin Institute for Independent Scholarship, API-X stakeholder, Data Manager/Informaticist, ex-operations manager, ex-archive manager, ex-systems engineer, ex-software engineer & developer
- Joshua Westgard - University of Maryland Libraries, API-X stakeholder, repository application manager
- Aaron Birkland - Johns Hopkins, Software Engineer, API-X developer
- Aaron Coburn and Bethany Seeger - Amherst College, API-X stakeholder and developers of the Amherst extensions used throughout the demo