Upgrade to Pro — share decks privately, control downloads, hide ads and more …
Sign up for free

Writing Inclusive & Localized Docs for Global C...

Avatar for Trust Jamin Okpukoro Trust Jamin Okpukoro
November 05, 2022
Technology
290
1

Writing Inclusive & Localized Docs for Global Communities

Avatar for Trust Jamin Okpukoro

Trust Jamin Okpukoro

November 05, 2022

More Decks by Trust Jamin Okpukoro

See All by Trust Jamin Okpukoro
Bridging the Gap: Documenting APIs for Humans and LLMs
Avatar for Trust Jamin Okpukoro codejagaban
1
140
Navigating Travel Requirements for DevRels in Africa
Avatar for Trust Jamin Okpukoro codejagaban
1
84
What's new in Supabase LW14
Avatar for Trust Jamin Okpukoro codejagaban
1
150
Creating World-Class User Experience Design for API Documentation
Avatar for Trust Jamin Okpukoro codejagaban
1
500
Collaborative Development with Jira and GitHub
Avatar for Trust Jamin Okpukoro codejagaban
1
140
Leveraging Server-side Rendering for Enhanced Web Performance and SEO
Avatar for Trust Jamin Okpukoro codejagaban
1
340
Becoming a developer.pdf
Avatar for Trust Jamin Okpukoro codejagaban
3
220
Jira and Frontend Development
Avatar for Trust Jamin Okpukoro codejagaban
3
260
Designing a Good Product
Avatar for Trust Jamin Okpukoro codejagaban
2
150

Other Decks in Technology

See All in Technology
あるけみー式LTスライド作成術
Avatar for Ryotaro Harada alchemy1115
1
210
生成AIエージェントを用いた、 手動テスト手順書から自動テストへの 変換手法の検討
Avatar for MagicPod magicpod
0
160
Geolonia の開発現場における AIの活用について
Avatar for Takayuki Miyauchi miya0001
0
100
LTのテーマ どうきめてる？〜5つの型と私のやり方〜
Avatar for Yuuki Yamashita yama3133
1
110
銀行勘定系システムにおける開発プロセス刷新×AIによる環境モダナイゼーション / Development Process Transformation and AI-Driven Environment Modernization
Avatar for 三菱UFJインフォメーションテクノロジー株式会社 muit
0
2.2k
Deployment の 先にある AI Agent 基盤 - kagent vNext、Agent Substrate、Hermes から読み解く Agent Runtime の現在地 / k8s-matsuri-2-ai-agent-platform-amsy810
Avatar for Masaya Aoyama (@amsy810) masayaaoyama
3
570
AI に書かせたその API、 “信頼” できますか？
Avatar for 草薙昭彦 nagix
0
110
登壇の自信を奪う3匹のオバケ / 3 Ghosts That Rob You of Your Confidence in Public Speaking
Avatar for Pauli pauli
8
940
バイブコーディング時代のWebアプリ開発入門~Cloud Runで学ぶセキュアなビルドとデプロイ
Avatar for 尾﨑勇太/Yuta Ozaki waiwai2111
1
130
越境するなら専門用語を使うな高校校歌 / If you wanna cross border, you shouldn't use jargon
Avatar for VTRyo vtryo
0
140
空間オーディオで過去の 自分（ゴースト）と競うランニング 〜HealthKitのルートを足音に変える実装〜
Avatar for Nao-RandD nao_randd
0
220
データ界隈LT祭 第1回LT登壇
Avatar for タロウ taromatsui_cccmkhd
1
1.4k

Featured

See All Featured
Building an army of robots
Avatar for Kyle Neath kneath
307
46k
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
Avatar for Addy Osmani addyosmani
10
1.3k
Lightning talk: Run Django tests with GitHub Actions
Avatar for Sarah Abderemane sabderemane
0
250
Abbi's Birthday
Avatar for Violet Bock coloredviolet
4
10k
Discover your Explorer Soul
Avatar for Emna emna__ayadi
2
1.3k
GraphQLとの向き合い方2022年版
Avatar for Yosuke Kurami quramy
50
15k
Making Projects Easy
Avatar for Brett Harned brettharned
120
6.8k
Agile Actions for Facilitating Distributed Teams - ADO2019
Avatar for Mark Kilby mkilby
0
280
A Tale of Four Properties
Avatar for Chris Coyier chriscoyier
163
24k
Measuring Dark Social's Impact On Conversion and Attribution
Avatar for Stephen Akadiri stephenakadiri
2
280
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
Avatar for mongodb mongodb
50
10k
How Fast Is Fast Enough? [PerfNow 2025]
Avatar for Tammy Everts tammyeverts
3
880

Transcript

  1. Trust Jamin Writing inclusive & localized docs for global communities.

    Building for Africa

  2. Why Part 1 Why this talk Why Africa matters How

    Part 2 Principles and localization How we’ll win What Part 3 What can you do today? The call to arms Q&A Part 4 Agenda 2

  3. 3 Ever tried setting up a payment gateway and realized

    it doesn’t support your country’s popular method of payment?

  4. Why This Talk 4

  5. 6 Why Africa matters!

  6. Africa matters because Devs Africa 7

  7. The Gaps in Global Docs Dollar-centric examples U.S. idioms &

    metaphors Unsupported infra (e.g., mobile money, mobile transfer)

 Cultural insensitivity 8

  8. Inclusive Writing Principles Plain language Clear navigation No idioms Community

    input Visual explanations 10

  9. Tools & Workflows 9

  10. Shoutout to African Communities 9

  11. 11 How we’ll win

  12. What You Can Do Today Audit your docs
 Add local

    examples Build a style guide Invite local voices Make docs a team sport 13

  13. “Global tools need local docs.”
 Let’s build them—together

  14. Questions? @0xJamin 20 Q&A