Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Writing Inclusive & Localized Docs for Global C...
Search
Trust Jamin Okpukoro
November 05, 2022
Technology
1
250
Writing Inclusive & Localized Docs for Global Communities
Trust Jamin Okpukoro
November 05, 2022
Tweet
Share
More Decks by Trust Jamin Okpukoro
See All by Trust Jamin Okpukoro
Bridging the Gap: Documenting APIs for Humans and LLMs
codejagaban
1
33
Navigating Travel Requirements for DevRels in Africa
codejagaban
1
35
What's new in Supabase LW14
codejagaban
1
110
Creating World-Class User Experience Design for API Documentation
codejagaban
1
450
Collaborative Development with Jira and GitHub
codejagaban
1
110
Leveraging Server-side Rendering for Enhanced Web Performance and SEO
codejagaban
1
290
Becoming a developer.pdf
codejagaban
3
160
Jira and Frontend Development
codejagaban
3
240
Designing a Good Product
codejagaban
2
120
Other Decks in Technology
See All in Technology
スタートアップの現場で実践しているテストマネジメント #jasst_kyushu
makky_tyuyan
0
140
AI時代の発信活動 ~技術者として認知してもらうための発信法~ / 20251028 Masaki Okuda
shift_evolve
PRO
1
120
RemoteFunctionを使ったコロケーション
mkazutaka
1
140
What's new in OpenShift 4.20
redhatlivestreaming
0
370
進化する大規模言語モデル評価: Swallowプロジェクトにおける実践と知見
chokkan
PRO
0
110
From Natural Language to K8s Operations: The MCP Architecture and Practice of kubectl-ai
appleboy
0
350
OSSで50の競合と戦うためにやったこと
yamadashy
3
1k
re:Inventに行くまでにやっておきたいこと
nagisa53
0
720
戦えるAIエージェントの作り方
iwiwi
2
790
SREのキャリアから経営に近づく - Enterprise Risk Managementを基に -
shonansurvivors
0
250
プレイドのユニークな技術とインターンのリアル
plaidtech
PRO
1
490
仕様駆動開発を実現する上流工程におけるAIエージェント活用
sergicalsix
8
3.7k
Featured
See All Featured
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
37
2.6k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
508
140k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
panda_program
116
20k
Fashionably flexible responsive web design (full day workshop)
malarkey
407
66k
Gamification - CAS2011
davidbonilla
81
5.5k
Building Flexible Design Systems
yeseniaperezcruz
329
39k
Testing 201, or: Great Expectations
jmmastey
45
7.7k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
359
30k
The World Runs on Bad Software
bkeepers
PRO
72
11k
Why Our Code Smells
bkeepers
PRO
340
57k
Optimizing for Happiness
mojombo
379
70k
Mobile First: as difficult as doing things right
swwweet
225
10k
Transcript
Trust Jamin Writing inclusive & localized docs for global communities.
Building for Africa
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 Ever tried setting up a payment gateway and realized
it doesn’t support your country’s popular method of payment?
Why This Talk 4
6 Why Africa matters!
Africa matters because Devs Africa 7
The Gaps in Global Docs Dollar-centric examples U.S. idioms &
metaphors Unsupported infra (e.g., mobile money, mobile transfer) Cultural insensitivity 8
Inclusive Writing Principles Plain language Clear navigation No idioms Community
input Visual explanations 10
Tools & Workflows 9
Shoutout to African Communities 9
11 How we’ll win
What You Can Do Today Audit your docs Add local
examples Build a style guide Invite local voices Make docs a team sport 13
“Global tools need local docs.” Let’s build them—together
Questions? @0xJamin 20 Q&A