TopoToolbox 3 Group Meeting (2024-05-08)

[wkearn]

08.05.2024
12:00 -- 14:00

Agenda

Progress Report (15 Minutes)

Demo (Theo): pytopotoolbox
Demo (Will): C API + benchmarks
Demo (Wolfgang): MATLAB - TTLEM3D (testing new toolbox deployment)

Activity: Personas (20 Minutes)

Users may have very different motivations, needs and frustrations when using TopoToolbox than we do. Personas are fictional characters that we create based on our experiences interacting with (potential) users. They can help us prioritize our work by keeping a concrete user experience in mind.

Let’s work together to build a couple of personas for hypothetical users of TopoToolbox. Then we can generate ideas for features based on the needs of these users.

DIRK: I think that's a very good idea. As mentioned in our first meetings, I underscore the "ease of access and use" as one of the key features that made TT successful. This should be kept even on other platforms.

Discussion (20 Minutes)

Feel free to add any questions or discussion points that you would like to discuss with the group.

• Long-term maintenance plans
• DIRK: intermediate goals and milestones should be defined

Notes

• (ULM) Developer focused documentation for every repository, on how it works
• Add a readme to the Github page to notify visitors

PERSONAS:
{Name, role, goals/motivations, frustrations}
Steve, PhD student, [Wants to get something out of a DEM], [Where do I start? Code is a bit scary]
Maggie, PhD student (GIS user), [Advisor said chi was important], [Takes too long to get results; scientific meaning is obscure]
Robert, Postdoc, [Has research program; wants to develop new analyses], [performance, missing features, interface other tools/software]

C library:
R needs to know what the code does
Packages:
S wants an overview of opportunities and functions (Matlab's "methods")
S wants to have simply copy-paste examples in each function
S wants to know what he should choose for what reason (Matlab, R, Python)
M wants to have example scripts to execute and learn what combinations of functions can get her to
M wants to references to scientific papers in the help functions
R needs to know how to contribute code
Process:
S wants code examples and getting started docs that let him get started quickly
Community:
S wants to know why he should use TT3 at all?
S & M need a short (tldr) and long manual/reference about TT3
R needs a checklist of functions that exist in different languages
R needs to know how to access and interact with TT through GitHub (simple entry instructions)