Week 2, Day 4: Thursday, July 21, 2022
Synopsis
Data access and APIs. The morning sessions focus on accommodating both the developer-user and the eventual end-user. First, we live code the map feature using a Mapbox JS library. In the second session we introduce Application Programming Interfaces (APIs). Next, participants learn to collaborate using Github projects and implement semantic versioning. The special topic session is a presentation on IIIF from Jeffrey Witt.
Outcome goals
- Evaluate whether the best visualization for your data is a map.
- Learn how to use external documentation and tutorials to create and adapt code for your project.
- Introduce external APIs.
- Understand CRUD, nouns, and verbs.
- Understand REST, HTTP, and URIs.
- Make an API call to eXist-db.
- Use branches effectively.
- Learn about version numbering.
Legend
- Presentation: by instructors
- Discussion: instructors and participants
- Talk lab: participants discuss or plan in small groups
- Code lab: participants code alone or in small groups
9:00–10:30: Visualizing our geodata and integrating external APIs
Edition repo stages for session
| Time | Topic | Type |
|---|---|---|
| 15 min | Write the model for our geodata and explore our ideas on how visual information can be displayed. | Talk lab |
| 15 min | Choose the right mapping tools for your project. | Talk lab |
| 30 min | Integrate basic map functionality into the app using a mapping JS library. | Presentation |
| 30 min | (TEI) Graphing inside eXist-db. | Presentation |
10:30–11:00: Coffee break
11:00–12:30: Application programming interfaces (API)
Edition repo stages for session
| Time | Topic | Type |
|---|---|---|
| 30 min | What is an Application Programming Interface (API)? | Presentation |
| 30 min | Our verb and noun choices, how we made them, what we might have done differently. | Presentation |
| 30 min | Documenting our decisions. | Talk lab |
12:30–2:00: Lunch
2:00–3:30: Review and practice: version control and project management with git and GitHub.
Edition repo stages for session
| Time | Topic | Type |
|---|---|---|
| 20 min | Github projects. | Code lab |
| 20 min | Releases and semantic versioning. | Presentation |
| 15 min | Project management reflections. | Discussion |
| 35 min | Planning our own projects. | Talk lab |
3:30–4:00: Coffee break
4:00–5:30: Special topic: IIIF with Jeffrey Witt
| Time | Topic | Type |
|---|---|---|
| 90 min | International Image Interoperability Framework (IIIF) and Linked Open Data (LOD). | Presentation |
We’ll end each day with a request for feedback, based on a general version of the day’s outcome goals, and we’ll try to adapt on the fly to your responses. Links to the feedback forms are in our Slack workspace in the #daily-feedback channel (posting from Mason on Mon, July 11).