Skip to content

Commit 9a0c43e

Browse files
committed
value prop and customer experience text improvements
1 parent 966bfe0 commit 9a0c43e

6 files changed

Lines changed: 57 additions & 55 deletions

File tree

src/data/canvas/localizedData.json

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
},
2020
"apiValueProposition": {
2121
"section": "Wertversprechen der API",
22-
"description": "Welchen Wert bietet die API den API-Konsumenten?"
22+
"description": "Beginnen Sie mit einem Haftzettel, auf dem Sie die API oder die API-Familie benennen, und erfassen Sie dann, welchen Nutzen die API den API-Nutzern bietet."
2323
},
2424
"developerRelations": {
2525
"section": "Entwicklerbeziehungen",
@@ -45,20 +45,20 @@
4545
},
4646
"apiValuePropositionCanvas": {
4747
"title": "API Value Proposition Canvas",
48-
"purpose": "Berücksichtigt diese API die Aufgaben, Probleme (Pains) und Bedürfnisse (Gains) der API-Konsumenten?",
49-
"howToUse": "Beschreiben Sie die Sichtweise des API-Konsumenten, beginnend mit seinen Aufgaben, dann seine Pains und Gains, und schließlich die API-Produkte und -Features.",
48+
"purpose": "Wie lässt sich die Customer Journey auf APIs abbilden? Welche Probleme und Vorteile von Endnutzern und API-Nutzern müssen berücksichtigt werden?",
49+
"howToUse": "Beschreiben Sie die Perspektive der Endnutzer, beginnend mit ihren Aufgaben, dann die Probleme und Vorteile von Endnutzern und API-Nutzern und schließlich die Produkte und Funktionen der API.",
5050
"sections": {
5151
"tasks": {
5252
"section": "Aufgaben",
53-
"description": "Was wollen die API-Konsumenten erreichen?"
53+
"description": "Was wollen die Kunden (Endnutzer) erreichen?"
5454
},
5555
"gainEnablingFeatures": {
5656
"section": "Nutzenstiftende Features",
5757
"description": "Welche Features ermöglichen es API-Konsumenten ihre Bedürfnisse zu bedienen?"
5858
},
5959
"painRelievingFeatures": {
6060
"section": "Problemlösende Features",
61-
"description": "Welche Features ermöglichen es API-Konsumenten ihre Probleme zu überwinden?"
61+
"description": "Welche Funktionen helfen Endnutzern und API-Nutzern, Probleme zu überwinden?"
6262
},
6363
"apiProducts": {
6464
"section": "API-Produkte",
@@ -406,7 +406,7 @@
406406
},
407407
"apiValueProposition": {
408408
"section": "API Value Proposition",
409-
"description": "What value does the API offer to API consumers?"
409+
"description": "Start with one sticky note naming the API or API family, then capture what value the API offers to API consumers."
410410
},
411411
"developerRelations": {
412412
"section": "Developer Relations",
@@ -432,20 +432,20 @@
432432
},
433433
"apiValuePropositionCanvas": {
434434
"title": "API Value Proposition Canvas",
435-
"purpose": "Does this API address the jobs, pains, and gains of API consumers?",
436-
"howToUse": "Describe the API consumer's perspective, starting with their tasks, then their pains and gains, and finally the API's products and features.",
435+
"purpose": "How does the customer journey map to APIs? What end-user and API consumer pains, and gains need to be addressed?",
436+
"howToUse": "Describe the end-users' perspective, starting with their tasks, then their and API consumers' pains and gains, and finally the API's products and features.",
437437
"sections": {
438438
"tasks": {
439439
"section": "Tasks",
440-
"description": "What are the API consumers trying to achieve?"
440+
"description": "What are the customers (end-users) trying to achieve?"
441441
},
442442
"gainEnablingFeatures": {
443443
"section": "Gain Enabling Features",
444-
"description": "What features enable API consumers to achieve gains?"
444+
"description": "What features enable end-users and API consumers to achieve gains?"
445445
},
446446
"painRelievingFeatures": {
447447
"section": "Pain Relieving Features",
448-
"description": "What features help API consumers overcome pains?"
448+
"description": "What features help end-users and API consumers overcome pains?"
449449
},
450450
"apiProducts": {
451451
"section": "API Products",
@@ -518,7 +518,7 @@
518518
"customerJourneyCanvas": {
519519
"title": "Customer Journey Canvas",
520520
"purpose": "What is the customer or partner journey that the API is intended to support?",
521-
"howToUse": "Describe a real-life customer or user journeynot the API usageto reveal pain points, goals, and context. This insight helps define what kind of API support is truly needed later.",
521+
"howToUse": "In API Product Strategy, describe the real-life customer or partner journey, not the API usage, to reveal pain points, goals, and context. In API Consumer Experience, use this canvas for the API consumer journey from discovery and evaluation to onboarding, integration, troubleshooting, and ongoing use.",
522522
"sections": {
523523
"customerDiscoversNeed": {
524524
"section": "Customer Discovers Need",
@@ -793,7 +793,7 @@
793793
},
794794
"apiValueProposition": {
795795
"section": "APIn arvolupaus",
796-
"description": "Mitä arvoa API tarjoaa sen käyttäjille?"
796+
"description": "Aloita yhdellä tarralapulla, jossa nimeät APIn tai API-perheen, kerro sitten mitä arvoa API tarjoaa API-käyttäjille."
797797
},
798798
"developerRelations": {
799799
"section": "Suhde kehittäjiin",
@@ -819,20 +819,20 @@
819819
},
820820
"apiValuePropositionCanvas": {
821821
"title": "API Value Proposition Canvas",
822-
"purpose": "Vastaako tämä API API-käyttäjien tehtäviin, kipupisteisiin ja hyötyihin?",
823-
"howToUse": "Kuvaile API-käyttäjän näkökulma: aloita tehtävistä, siirry kipupisteisiin ja hyötyihin ja lopuksi esittele API-tuotteet ja -ominaisuudet.",
822+
"purpose": "Miten asiakaspolku liittyy API-rajapintoihin? Mitä loppukäyttäjien ja API-käyttäjien ongelmia ja hyötyjä on käsiteltävä?",
823+
"howToUse": "Kuvaile loppukäyttäjien näkökulmaa aloittaen heidän tehtävistään, sitten heidän ja API-käyttäjien ongelmista ja hyödyistä ja lopuksi API:n tuotteista ja ominaisuuksista.",
824824
"sections": {
825825
"tasks": {
826826
"section": "Tehtävät",
827-
"description": "Mitä API-käyttäjät yrittävät saavuttaa?"
827+
"description": "Mitä asiakkaat (loppukäyttäjät) yrittävät saavuttaa?"
828828
},
829829
"gainEnablingFeatures": {
830830
"section": "Hyötyä mahdollistavat ominaisuudet",
831-
"description": "Mitkä ominaisuudet mahdollistavat API-käyttäjien hyötyjen saavuttamisen?"
831+
"description": "Mitkä ominaisuudet mahdollistavat loppukäyttäjien ja API-käyttäjien hyötyjen saavuttamisen?"
832832
},
833833
"painRelievingFeatures": {
834834
"section": "Kipua lievittävät ominaisuudet",
835-
"description": "Mitkä ominaisuudet auttavat API-käyttäjiä poistamaan kipupisteet?"
835+
"description": "Mitkä ominaisuudet auttavat loppukäyttäjiä ja API-käyttäjiä voittamaan ongelmia?"
836836
},
837837
"apiProducts": {
838838
"section": "APIn tuotteet",
@@ -1180,7 +1180,7 @@
11801180
},
11811181
"apiValueProposition": {
11821182
"section": "Proposition de valeur de l'API",
1183-
"description": "Quelle valeur l'API offre-t-elle aux consommateurs d'API?"
1183+
"description": "Commencez par une note adhésive indiquant le nom de l'API ou de la famille d'API, puis notez la valeur ajoutée que l'API offre aux consommateurs d'API."
11841184
},
11851185
"developerRelations": {
11861186
"section": "Relations développeurs",
@@ -1206,20 +1206,20 @@
12061206
},
12071207
"apiValuePropositionCanvas": {
12081208
"title": "API Value Proposition Canvas",
1209-
"purpose": "Cette API répond-elle aux tâches, peines et gains des consommateurs d'API?",
1210-
"howToUse": "Décrivez le point de vue du consommateur d'API, en commençant par ses tâches, puis ses peines et gains, et enfin les produits et fonctionnalités de l'API.",
1209+
"purpose": "Comment le parcours client s'articule-t-il avec les API ? Quels sont les problèmes et les avantages rencontrés par les utilisateurs finaux et les consommateurs d'API ?",
1210+
"howToUse": "Décrire le point de vue des utilisateurs finaux, en commençant par leurs tâches, puis leurs problèmes et avantages ainsi que ceux des consommateurs d'API, et enfin les produits et fonctionnalités de l'API.",
12111211
"sections": {
12121212
"tasks": {
12131213
"section": "Tâches",
1214-
"description": "Qu'essaient d'accomplir les consommateurs d'API?"
1214+
"description": "Qu'est-ce que les clients (utilisateurs finaux) cherchent à réaliser ?"
12151215
},
12161216
"gainEnablingFeatures": {
12171217
"section": "Fonctionnalités génératrices de gains",
1218-
"description": "Quelles fonctionnalités permettent aux consommateurs d'API d'obtenir des gains?"
1218+
"description": "Quelles fonctionnalités permettent aux utilisateurs finaux et aux consommateurs d'API de réaliser des gains ?"
12191219
},
12201220
"painRelievingFeatures": {
12211221
"section": "Fonctionnalités soulageant les peines",
1222-
"description": "Quelles fonctionnalités aident les consommateurs d'API à surmonter leurs difficultés?"
1222+
"description": "Quelles fonctionnalités aident les utilisateurs finaux et les consommateurs d'API à surmonter les difficultés ?"
12231223
},
12241224
"apiProducts": {
12251225
"section": "Produits API",
@@ -1567,7 +1567,7 @@
15671567
},
15681568
"apiValueProposition": {
15691569
"section": "Proposta de valor da API",
1570-
"description": "Que valor a API oferece aos consumidores da API?"
1570+
"description": "Comece com um post-it nomeando a API ou a família de APIs e, em seguida, anote o valor que a API oferece aos seus consumidores."
15711571
},
15721572
"developerRelations": {
15731573
"section": "Relações com desenvolvedores",
@@ -1593,20 +1593,20 @@
15931593
},
15941594
"apiValuePropositionCanvas": {
15951595
"title": "API Value Proposition Canvas",
1596-
"purpose": "Esta API aborda as tarefas, dificuldades e ganhos dos consumidores da API?",
1597-
"howToUse": "Descreva a perspectiva do consumidor da API, começando pelas suas tarefas, depois pelos seus problemas e ganhos e, finalmente, pelos produtos e funcionalidades da API.",
1596+
"purpose": "Como a jornada do cliente se relaciona com as APIs? Quais dificuldades e benefícios dos usuários finais e consumidores de API precisam ser abordados?",
1597+
"howToUse": "Descreva a perspectiva dos usuários finais, começando com suas tarefas, depois suas dificuldades e benefícios e os dos consumidores de API e, finalmente, os produtos e recursos da API.",
15981598
"sections": {
15991599
"tasks": {
16001600
"section": "Tarefas",
1601-
"description": "O que os consumidores da API pretendem alcançar?"
1601+
"description": "O que os clientes (usuários finais) estão tentando alcançar?"
16021602
},
16031603
"gainEnablingFeatures": {
16041604
"section": "Recursos que possibilitam ganhos",
1605-
"description": "Quais recursos permitem que os consumidores da API obtenham ganhos?"
1605+
"description": "Quais recursos permitem que os usuários finais e consumidores de API alcancem ganhos?"
16061606
},
16071607
"painRelievingFeatures": {
16081608
"section": "Recursos que aliviam dificuldades",
1609-
"description": "Quais recursos ajudam os consumidores da API a superar dificuldades?"
1609+
"description": "Quais recursos ajudam os usuários finais e os consumidores da API a superar dificuldades?"
16101610
},
16111611
"apiProducts": {
16121612
"section": "Produtos API",

src/data/method/de/labels.stations.json

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,9 @@
1212
"station.api-consumer-experience.title": "API Consumer Experience - Design für die echten Benutzer Ihrer API",
1313
"station.api-consumer-experience.description": "Stellen Sie sicher, dass Ihre API auffindbar, verständlich und nutzbar ist - vor und nach der Einführung.",
1414
"station.api-consumer-experience.why_it_matters": "Großartige APIs funktionieren nicht nur - sie fühlen sich auch intuitiv an. Ganz gleich, ob Ihr Kunde ein interner Entwickler, ein externer Partner oder ein KI-Agent ist, seine Erfahrung entscheidet über die Akzeptanz.\n\nOhne einen klaren Erlebnisplan:\n- Großartige APIs bleiben ungenutzt\n- Teams verschwenden Zeit damit, zu raten, wie sie Ihre API verwenden sollen\n- Feedbackschleifen sind unterbrochen oder fehlen.\n\nDiese Station hilft Ihnen, Ihre API mit den Augen ihrer Nutzer zu sehen.",
15-
"station.api-consumer-experience.how_it_works": "Ordnen Sie Ihre API-Verbraucher und deren Anforderungen für das Onboarding mithilfe einer Onboarding-Journey-Vorlage oder des Customer Journey Canvas zu.",
16-
"station.api-consumer-experience.how_it_works.1": "Definieren Sie die API-Consumer-Journey von der Entdeckung bis zur Fehlerbehebung und identifizieren Sie wichtige Berührungspunkte und Schwachstellen.", "station.api-consumer-experience.apply_in_work": "Bereitstellung von Richtlinien, Tools und Feedback-Mechanismen für das Verständnis, die Analyse und die Verbesserung der internen und externen Erfahrungen von Entwicklern und Partnern.",
15+
"station.api-consumer-experience.how_it_works": "Überprüfen Sie das bestehende API Value Proposition Canvаs von der Perspektive des API-Nutzers. Stellen Sie die Stabilität der unterstützten Geschäftsprozesse sicher und ergänzen Sie die Funktionen, die Probleme lösen und Vorteile bieten, um die Bedürfnisse der API-Nutzer zu berücksichtigen, damit diese spätere Designentscheidungen leiten können.",
16+
"station.api-consumer-experience.how_it_works.1": "Nutzen Sie das Customer Journey Canvas für die API-Nutzerreise von der Entdeckung und Bewertung über Onboarding, Integration und Fehlerbehebung bis hin zur laufenden Nutzung.“",
17+
"station.api-consumer-experience.apply_in_work": "Bereitstellung von Richtlinien, Tools und Feedback-Mechanismen für das Verständnis, die Analyse und die Verbesserung der internen und externen Erfahrungen von Entwicklern und Partnern.",
1718
"station.api-consumer-experience.outcomes": "Identifizieren und priorisieren Sie Ihre API-Kunden",
1819
"station.api-platform-architecture.title": "API-Plattformarchitektur - Architektur von APIs für Skalierbarkeit und Wiederverwendung",
1920
"station.api-platform-architecture.description": "Gewährleisten Sie Skalierbarkeit, Wiederverwendung und Governance für Ihre API- und Plattformkomponenten.",
@@ -204,7 +205,7 @@
204205
"station.api-product-strategy.outcomes.1": "Gemeinsame Sprache zwischen Produkt, Design und Technik",
205206
"station.api-product-strategy.outcomes.2": "Ein solides Argument für die Finanzierung/Bewilligung",
206207
"station.api-product-strategy.how_it_works.1": "Definieren Sie zentrale Entitäten, ihre Attribute und Beziehungen, um ein gemeinsames konzeptionelles Verständnis für alle Journeys und eventuell APIs zu schaffen.",
207-
"station.api-product-strategy.how_it_works.2": "Identifizieren Sie die Bedürfnisse der Entwickler und neue oder wiederverwendbare APIs mithilfe des API Value Proposition Canvas.",
208+
"station.api-product-strategy.how_it_works.2": "Ermitteln Sie mithilfe des API Value Proposition Canvas die Bedürfnisse von Endbenutzern und API-nutzenden Entwicklern sowie von neuen oder wiederverwendbaren APIs.",
208209
"station.api-product-strategy.how_it_works.3": "Definieren Sie den Wert - für die Nutzer und das Unternehmen - mit dem API Business Model Canvas, um Ihre API-Strategie visuell, gemeinsam nutzbar und einfach mit Ihren API-Kunden an der nächsten Station zu validieren.",
209210
"station.api-consumer-experience.outcomes.1": "Definieren Sie die API-Erlebnisreise",
210211
"station.api-consumer-experience.outcomes.2": "Onboarding, Dokumentation und Feedback planen",

src/data/method/en/labels.stations.json

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,14 @@
1010
"station.api-product-strategy.outcomes.2": "A solid pitch or case for funding/approval",
1111
"station.api-product-strategy.how_it_works": "Explore the customer or partner problem you expect to solve with APIs. Map the stakeholders, ther journeys and outcomes using the Customer Journey canvas.",
1212
"station.api-product-strategy.how_it_works.1": "Define core entities, their attributes, and relationships to create a shared conceptual understanding across journeys and eventually APIs.",
13-
"station.api-product-strategy.how_it_works.2": "Identify the developer needs and new or reusable APIs using the API Value Proposition Canvas.",
13+
"station.api-product-strategy.how_it_works.2": "Use the API Value Proposition Canvas to capture the supported business tasks, and the end-users' and the API consumers' pains, gains, and features that shape new or reusable APIs.",
1414
"station.api-product-strategy.how_it_works.3": "Define the value — for users and the business with the API Business Model canvas to make your API strategy visual, shareable, and easy to validate with your API consumers at the next station.",
1515
"station.api-consumer-experience.title": "API Consumer Experience - Design for Your API’s Real Users",
1616
"station.api-consumer-experience.description": "Ensure your API is discoverable, understandable, and usable — before and after launch.",
1717
"station.api-consumer-experience.why_it_matters": "Great APIs don’t just work — they feel intuitive. Whether your consumer is an internal developer, external partner, or AI agent, their experience determines adoption.\n\nWithout a clear experience plan:\n- Great APIs go unused\n- Teams waste time guessing how to use your API\n- Feedback loops are broken or missing.\n\nThis station helps you see your API through the eyes of its consumers.",
18-
"station.api-consumer-experience.how_it_works": "Map your API consumers and their needs for onboarding using an onboarding journey template or the Customer Journey Canvas.",
19-
"station.api-consumer-experience.how_it_works.1": "Define the API consumer journey from discovery to troubleshooting, identifying key touchpoints and pain points.",
18+
"station.api-consumer-experience.how_it_works": "Review the existing API Value Proposition Canvas from the API consumer perspective. Keep the supported business tasks stable, and enrich the pain-relieving and gain-enabling features with API consumer concerns so they can guide later design decisions.",
19+
"station.api-consumer-experience.how_it_works.1": "Use the Customer Journey Canvas for the API consumer journey from discovery and evaluation to onboarding, integration, troubleshooting, and ongoing use.",
20+
"station.api-consumer-experience.how_it_works.2": "Use the resulting journey to improve onboarding, documentation, support, and feedback loops for the API consumer.",
2021
"station.api-consumer-experience.apply_in_work": "Provide guidelines, tools, and feedback mechanisms for understanding, analyzing, and improving internal and external developer and partner experience.",
2122
"station.api-consumer-experience.outcomes": "Identify and prioritize your API consumers",
2223
"station.api-consumer-experience.outcomes.1": "Define the API experience journey",

0 commit comments

Comments
 (0)