Skip to content

Instantly share code, notes, and snippets.

@sabman
Last active July 20, 2026 10:29
Show Gist options
  • Select an option

  • Save sabman/52dc8ece16f26af301bf1a863369a88b to your computer and use it in GitHub Desktop.

Select an option

Save sabman/52dc8ece16f26af301bf1a863369a88b to your computer and use it in GitHub Desktop.
Senegal Mon 20 internal brief and speaker notes

Senegal workshop — simple agenda (Mon 20 Jul)

When: 14:00-16:30 Dakar
Where: OpenTalk (link in invite)
Survey: https://kyc20-data-lineage-production.up.railway.app/


Agenda

Time Block Key point
Open Benefits for all cities and all years This helps everyone, everywhere, over time — not only Ziguinchor today
5 min Kblock demo Existing map data can support real decisions when combined with federation data
25 min Data survey online Document what you have and what you plan — we ask, we do not assign
5 min Break (after survey) Pause and connect the next blocks to what you actually heard
15 min Use cases on whiteboard Name real problems in real work — not features or technology
15 min Connect survey to use cases Every priority use case needs data behind it — or an honest gap
10 min Break (before personas) Reset before empathy work — review notes from survey and use cases
15 min Personas A good persona is someone you can picture: name, job, goal, frustration, data need
30 min Persona user stories One concrete story per role, tied to data from the survey
Close Conclusion Read back what we agreed — no new topics

Before we start — say this once

Key point: The value of this project is for all programme cities and across years — include data you already hold, not only what this project will collect.

Today we focus on Ziguinchor, but the platform is meant to help all seven programme cities. It should also hold data from different years — old maps and surveys matter as much as new ones. When you document what you have and what you plan, you are helping your city and the wider network. The survey is not only about data from this project; include anything your federation already holds from earlier work.


5 min — Kblock demo

Key point: This demo shows what is possible when map layers are used for local decisions — it is motivation, not the final product.

Show Kblock as a real example of what good use of map data can look like. OpenStreetMap is one input; the point is turning existing map layers into something useful for local decisions (for example seeing patterns block by block). Say clearly this is a motivation demo, not the final product. OpenStreetMap on its own is not enough — it works best when combined with federation data such as settlement boundaries and field surveys. After the demo, ask: which layer do you already have, which is missing, and who in your team looks after it?


25 min — Data survey online

Key point: The survey is a shared picture of your data landscape — we capture what exists, what is planned, and who is responsible, only when you are ready to say.

Walk through the lineage survey together. People sign in, pick Senegal, and fill what they know — they do not need to finish everything today. For each dataset: does it exist now, is it planned, or not applicable? If something is missing, ask gently whether they plan to collect it, roughly when, under which project, and who would be responsible — only if they are ready to answer. Note to confirm where they are unsure. Fix any wrong or placeholder rows (for example copied example text on OpenStreetMap). Drone flights were not allowed in Ziguinchor for law-and-order reasons; street-level mapping was discussed as an alternative — if they confirm, add it as a possible new dataset type.


5 min — Break (after survey)

Key point: Use this pause to turn survey answers into useful input for the whiteboard — not to start the next block cold.

Pause the session. Tell participants you will be back in five minutes.

For you (internal): use this time to gather lessons from the survey block — what was filled, what is still missing, who owns what, any surprises or blockers. Jot quick notes before moving to the whiteboard so use cases and personas connect to what you actually heard, not what you assumed.

« On fait une pause de cinq minutes. On reprend dans un instant pour la partie tableau blanc. »


15 min — Use cases on the whiteboard

Key point: A good use case starts with a problem someone faces this month — not a wish for a better system.

Ask what problems the city platform must help with in real life: preparing for a meeting with the mairie, showing service gaps on a map, linking a story to a place, exporting numbers for a report. Write 4-6 use cases as short sticky notes. Do not debate technology. Pick the 2-3 that feel most urgent for Release 1.


15 min — Connect survey data to use cases

Key point: If a use case cannot point to data you have or plan to collect, it stays a wish — mark the gap honestly.

Draw lines on the whiteboard from each priority use case to the datasets in the survey that support it. If a use case has no data behind it, mark the gap — do not treat it as ready to build. If survey data has no use case yet, note it as available but unused or purpose unclear. This step stops wishlists: every important use case should point to data you have, plan to collect, or honestly lack.


10 min — Break (before personas)

Key point: Persona work needs empathy — take a breath and review what you learned before asking people to describe users.

Pause again before the persona block. Use the time to skim your survey and use-case notes so the examples you put on the board reflect Ziguinchor, not a generic template.

« Petite pause avant la partie personas — on reprend dans dix minutes. »


15 min — Personas

Key point: A good persona is someone you can picture — if you cannot name their job, goal, and frustration, it is still too vague.

Name the people who will actually use the platform or decide what others see. Avoid vague labels like community or government — rename into something concrete. Aim for up to five roles for the first release.

Checklist for a good persona:

  • A name or clear role label (not "the community")
  • Who they are and what they do day to day
  • One goal and one motivation (why they care)
  • One urgent need and one frustration today
  • What data they rely on and what access they need
  • What success looks like for them

Example persona (put on the board as a template — then ask the group to adapt or replace):

Aminata Diallo — community organiser, UrbaSEN Ziguinchor

Who she is Aminata is 34. She works with savings groups in two settlements in Ziguinchor. She is not a GIS expert; she uses a phone and sometimes a laptop at the UrbaSEN office.
What she does day to day Visits settlements, supports enumerators, prepares federation members for meetings with the city authority, and turns survey results into simple maps and talking points.
Goal Keep residents from losing their homes without evidence. Get the mairie to listen with dated maps and counts, not only stories.
Motivation Her aunt's settlement was cleared without warning. She does not want that to happen again without the federation being able to show who lives where and what services exist.
Urgent need Before the next council meeting in six weeks: one map with settlement boundaries, household counts, and water points — all from the same date, easy to show on a tablet.
Frustration today Data sits in different places — someone's Drive folder, paper notes, an old shapefile on one laptop. She spends days copying numbers into slides instead of organising.
Data she relies on Settlement boundaries, household enumeration, infrastructure (water, toilets), photos or stories linked to places.
Access she needs Read and export for meetings; she does not upload raw surveys herself — she asks the data manager.
What success looks like She opens the platform on her phone, picks her settlement, and has a map and summary she trusts enough to take into the mairie office.
Privacy concern Household names and phone numbers must not appear on anything the public or the council sees without explicit approval.

Ask the group: Who in your team is like Aminata — or different? Give them a name, a job, one goal, and one frustration.


30 min — Persona user stories

Key point: A good user story names one action on the platform and one outcome in real work — and points to data you documented in the survey.

For each priority persona, write one user story in plain language: As a [role], I want to [do something on the platform], so that [outcome in real work]. One story per role is enough in the room. Optionally rewrite one story in Given / When / Then form if the group finds it helpful. Keep stories tied to data you documented in the survey — if the story needs data that does not exist, note that as a gap rather than pretending it is there.


Conclusion

Key point: End with clarity — what we captured, what is still open, and how people can follow up if they want to.

Read back what you captured: main use cases, which data supports them, top personas, one story each, gaps and to confirm items. Mention who decides publish rules (controller vs day-to-day data manager) only at a high level if time allows — full rules come later. Offer a WhatsApp group for anyone who wants to continue the survey or clarify names after the session. Confirm you will send a short written summary within 48 hours. Thank people and stop the recording.


Tone reminder (facilitators)

Ask; do not assign. Capture plans only when participants share them. Personal data does not go on the public map by design — note sensitive cases for later governance discussion.

Senegal session — internal brief + speaker notes

Date: Mon 20 Jul 2026
Session: 14:00-16:30 Dakar / 16:00-18:30 Berlin
Internal audience: Shoaib, Myriam, Saqib, Fernando
OpenTalk: https://meet.opentalk.eu/room/60fb1399-1fb0-49dd-8af5-45b19acaa730?invite=dda1a71a-762c-4df7-93b3-6d1b170a1886


Q&A framing (internal)

Q: At 16:30 Dakar, what are the 3 non-negotiable outputs we must leave with?
A:

  1. Top 5 personas are identified with motivations, urgent needs, required data, expected access, and intended usage.
    Example: we know that a UrbaSEN community organiser uses settlement boundary data to prepare for council meetings, needs read access on the platform, and is blocked today because maps are scattered across different people's laptops.

  2. Data controllers and data custodians are identified (role first, names where possible), including hierarchy of control and allowed uses.
    Example: we know that the UrbaSEN programme coordinator decides what data can be shared with the city authority, and a named GIS staff member handles the day-to-day uploads and quality checks.

  3. Data types and their uses are identified, with privacy red flags captured and personal data marked as non-publishable by design.
    Example: we know that household enumeration data exists, is used for advocacy and planning, contains personal information, and will be kept internal on the platform — only aggregated settlement-level counts may appear on the public map.

Q: Which two items do we explicitly defer if time slips?
A:

  1. Detailed load-and-analyse workflow discussion (keep only essentials if needed).
    Example: if we run out of time, we skip the conversation about exactly how data files move from KoBo to the platform, and note it as a question for the technical design stage.

  2. Data quality deep dive (capture high-level issues only and defer full treatment to the August workshop).
    Example: if someone raises that their enumeration data has duplicate household IDs, we note it on the board and say we will work through quality rules properly in August — we do not try to solve it in the room today.


Executive summary

French combined session for Senegal (Ziguinchor / UrbaSEN): lineage survey completion plus persona, usage, and governance capture in one 2h30 block. We document what exists today and learn what affiliates plan next — we are not here to impose deadlines or fill the survey for them. Persona and accountability outputs feed inception and platform design.

Internal context note (not for participant-facing copy):

  • Ziguinchor is the Senegal city in scope for this project phase.
  • Drone data collection in Ziguinchor was reported as disallowed due to law and order constraints.
  • Street-level mapping was proposed as an alternative collection path; capture this as a potential new dataset in lineage if affiliates confirm.
  • State clearly in the room: the benefits of this project are for all spatial and time coverage across the network, not only the current project city.

Tone: curious and collaborative, not pushy. Ask; do not assign. If something is missing, capture whether they plan to collect it, by when (their estimate), under which project, and who is responsible — only if they are ready to say.

These are the top things to achieve during the workshop:

  1. For each primary dataset in the lineage survey, we know what exists today, what is missing, and — where relevant — whether the affiliate plans to collect it, by when, under which project, and who is responsible.
  2. The top 5 roles who will use the city platform are on the board, each with their motivations, urgent needs, required data, expected access, and how they plan to use it.
  3. Each priority role has at least one user story written in plain language (as a / I want / so that), so the team has concrete requirements to design against.
  4. The data controller and data custodian are identified for Ziguinchor — who decides what gets published, who manages data day to day, and what the data may be used for (role and name where people are ready to share).
  5. The main data types are linked to the roles and use cases they support, so we can see what data is needed for which purpose.
  6. Any personal or identifiable data cases are flagged, and participants understand that personal data will not be published on the public map by design.
  7. The blockers that stop affiliates from getting full value from their existing data are written down, with a note on who might help address them.
  8. A WhatsApp follow-up group is offered for anyone who wants to continue survey rows or governance questions after the session.
  9. The session is recorded with audio from all participants, saved, and ready to upload and share.
  10. A written summary of outcomes is sent to participants within 48 hours.

Not in scope today: a full permissions matrix by role (who can view, edit, or publish each dataset), second-release features, technical architecture decisions, and full legal sign-off.


Internal brief (share with team before call)

What this session is:
A combined French-language lineage + persona/usages workshop for Senegal (Ziguinchor / UrbaSEN). Two workshops compressed into 2h30. We help affiliates document what they have and what they plan — the survey is a shared picture, not a compliance exercise. Persona/usages outputs support the inception report and platform design.

The 5 outcomes we hope to leave with:

# Output Format
1 Top 5 roles/personas — motivations, urgent needs, required data, access/use tldraw board
2 Data controller and custodian identified (role + name if possible; hierarchy of decision rights; allowed uses) tldraw / notes
3 Data types and their uses identified per persona tldraw board
4 Personal data and privacy red flags flagged (personal data not publishable by design; anything requiring further governance noted) notes / checklist
5 Lineage survey — what exists today; for gaps: plan to collect? by when? which project? who is responsible? survey + notes

Explicitly out of scope today:
Full permissions matrix by role · second-release scope · technical architecture · full legal review.
Park with: "On note ça pour l'atelier d'août."

If no programme decision owner joins:
Capture outcomes as proposals. Label anything governance-sensitive as "en attente de validation par le Secrétariat". Do not commit Secretariat policy.

Scribe: [NAME] on tldraw — visible to all participants live.
Recording: [NAME] starts before welcome; checks after break; saves and uploads after.
Personal data rule to state once early: "Par conception, aucune donnée personnelle identifiable ne sera publiée sur la carte publique. Nous noterons les cas sensibles pour décision ultérieure."


Speaker notes (facilitator — block by block)

Open (0-5 min, 14:00 Dakar)

« Bonjour à toutes et à tous, bienvenue. Merci d'être là.
Aujourd'hui on a deux heures et demie ensemble. Le but principal : documenter les données de Ziguinchor dans le questionnaire, et comprendre qui utilisera la plateforme et pourquoi.
Pas de jargon technique. On note tout sur le tableau partagé.
On enregistre la session — si quelqu'un a une objection, dites-le maintenant. »

Two framing points to say aloud at the start:

  1. The data you have already counts. The lineage survey is not just about data collected under this project. It covers data your federation has gathered over many years, across programmes and contexts. If you have a settlement map from 2019 or an enumeration round from a previous project — that is exactly what we want to know about. We are building a picture of everything that exists, not just what is new.

  2. This applies across the network and over time. The platform is designed for all seven cities and for the long term, not just one project cycle. Data you collected five years ago and data you plan to collect next year are both relevant. We want to understand continuity, gaps, and what has changed — not just a snapshot of today.

  3. The benefit is wider than one city. Even though today's working session focuses on Ziguinchor, the value of this project is network-wide: better spatial coverage across settlements and better time coverage across different years, so affiliates can compare, plan, and advocate with stronger evidence.

→ Start recording before this. Paste survey link + OpenTalk link in chat.


Internal note — data-to-use-case traceability (for facilitator awareness):

When a use case or user story comes up, always ask for the data behind it. A good use case has three anchors:

  • Which dataset supports this use case? (e.g. settlement boundary + household enumeration)
  • Who owns it and what is its current status? (e.g. UrbaSEN holds it; collected 2023; digitised but not cleaned)
  • Is it already in the survey? If yes, link the story to that row. If no, add it as a new row or note.

This stops stories becoming wishlists. If a participant says "we want to show flood risk on the map" — ask "what flood data do you have today, who holds it, and what state is it in?" If the answer is "we don't have any yet," note the gap but do not design around absent data.


Lineage / survey (5-45 min, 14:05-14:45)

Motivation demo: Kblock app (run at the start of this block — ~2 minutes)

Show the Kblock app using OpenStreetMap as an input layer to turn existing map data into practical evidence.

Talk track (English — adapt into French as needed):

  • "This is a motivation demo, not the final product."
  • "Kblock shows how we can turn existing map data into practical evidence for local decisions."
  • "Here we use OpenStreetMap as one input layer, then combine it with community and survey data."
  • "The value is not only one city today — the same pattern works across cities and across time."
  • "This helps us see what data exists, what is missing, and what to collect next."

FR script (2 minutes):

« Ce que vous voyez ici n'est pas le produit final — c'est une démonstration pour montrer ce qui est possible.
L'application Kblock prend des données de carte existantes — comme OpenStreetMap — et les transforme en preuves concrètes pour des décisions locales.
OpenStreetMap seul n'est pas suffisant. Sa valeur est bien plus grande quand on le combine avec les données de la fédération — profils, limites de quartier, relevés de terrain.
Ce que nous voulons construire fonctionne pour toutes les villes du programme et dans la durée — pas seulement pour Ziguinchor aujourd'hui.
Regardez cette carte : quelle couche vous avez déjà ? Quelle couche manque ? Et qui dans votre équipe en est responsable ? »

Bridge question after demo (ask aloud):

« En regardant ça, quelle couche de données vous avez déjà, quelle couche manque, et qui dans votre équipe en serait responsable ? »

Do not over-promise: make clear OpenStreetMap alone is not sufficient — it is strongest when validated with federation data.


« On commence par le questionnaire. Je vais faire une démo rapide, puis on remplit ce que vous connaissez déjà — pas besoin de tout finir aujourd'hui. »

  • Demo: sign in → country → pick one dataset → fill → save. Show Serigne's OpenStreetMap row and how to fix example text.
  • Round-robin per dataset: exists today? planned? not applicable? personal data present?
  • For each gap, ask gently (do not pressure):
    • « Prévoyez-vous de collecter ces données ? »
    • « Si oui, à quelle échéance — même approximative ? »
    • « Dans le cadre de quel projet ? »
    • « Qui sera responsable ? »
  • If they are not sure: note "à confirmer" and offer WhatsApp follow-up. Do not assign names or dates for them.

Protect this block. Do not cut.


Break (45-50 min, 14:45)

« Cinq minutes de pause — revenez à 14h50. »

Check recording is still running.


Usages + personas + blocker question (50-75 min, 14:50-15:15)

« Maintenant : qui utilisera cette plateforme, et pourquoi ? »

  • Show starter roles on board (enumerator, data manager, federation leader, storyteller, local government).
  • Ask group to rename, add, remove. Vote to max 5 for first release.
  • For each top role: one user story. Use the format:
    « En tant que [rôle], je veux [action], afin de [résultat]. »
  • Gherkin optional — show flood example if helpful.
  • Blocker question (ask aloud, write answers on board):
    « Qu'est-ce qui vous empêche d'obtenir le plein potentiel des données que vous avez déjà ? »

Accountability (75-100 min, 15:15-15:40)

« Maintenant : qui décide quoi sur les données ? »

  • Contrôleur des données — qui décide ce qui est publié, ce qui reste interne, ce qui peut partir vers le tableau de bord réseau ?
  • Gestionnaire des données — qui charge, vérifie, prépare les couches au quotidien ?
  • Hierarchy: does city affiliate decide, or does Secretariat have override?
  • Allowed uses: advocacy, planning, donor reporting — which requires separate approval?
  • Personal data rule (restate): "Aucune donnée personnelle sur la carte publique — par conception. On note les cas à risque."
  • If names unavailable: capture role + "à nommer" + WhatsApp group follow-up.

Do not invent Secretariat policy. Capture options; label contested items as proposals.


Load & analyse — short (100-115 min, 15:40-15:55)

Cut this block first if running late.

« Comment les données entrent dans la plateforme, et comment vous les utilisez ensuite ? »

  • How does data move today: KoBo, Drive, HOT, QField?
  • What format do you want for analysis: map, spreadsheet export, report, pack for mairie meeting?

Data quality teaser (115-130 min, 15:55-16:10)

Cut second if running late.

« Un aperçu pour aujourd'hui : qu'est-ce qui ne va pas dans vos données actuelles ? Qui corrige quand ça échoue ? »

  • Note 2-3 pain points only. Full workshop in August.
  • Close with: "On reviendra là-dessus en détail en août."

End checklist + WhatsApp (130-145 min, 16:10-16:25)

« Avant de terminer, on passe en revue ce qu'on a. »

Read aloud and tick / note gap for each:

  • Survey: what exists today captured; for gaps — plan to collect, timing, project, responsible person (or à confirmer)
  • Top 5 roles with motivations, urgent needs, data, access/use
  • Data controller + custodian (role, hierarchy, allowed uses)
  • Data types and uses linked to personas
  • Personal data red flags noted; rule restated
  • Blockers captured
  • WhatsApp group offered for follow-up (optional for participants)
  • August data quality workshop flagged

« Si vous voulez continuer le questionnaire ou les questions de gouvernance après la session, on peut créer un groupe WhatsApp — c'est volontaire. »


Close (145-150 min, 16:25-16:30)

« Merci à toutes et à tous. Résumé écrit dans 48h. Pour le questionnaire : complétez ce que vous pouvez quand vous êtes prêts — on a noté vos plans pour les données manquantes. »

  • Recap any collection plans (timing, project, responsible person) only as participants stated them.
  • Stop recording.

After the session (owner: Shoaib / Myriam)

  • Save + upload recording; share link
  • Write fr-session-notes.md (French session notes) with outcomes, open items, and any collection plans participants shared
  • Gentle follow-up on WhatsApp only where participants asked for it or left items à confirmer
  • 48h written summary to participants
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment