Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
Writing Inclusive & Localized Docs for Global C...
Search
Trust Jamin Okpukoro
November 05, 2022
Technology
300
1
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Writing Inclusive & Localized Docs for Global Communities
Trust Jamin Okpukoro
November 05, 2022
Transcript
14 slides
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
More Decks by Trust Jamin Okpukoro
See All by Trust Jamin Okpukoro
Bridging the Gap: Documenting APIs for Humans and LLMs
codejagaban
1
160
Navigating Travel Requirements for DevRels in Africa
codejagaban
1
93
What's new in Supabase LW14
codejagaban
1
170
Creating World-Class User Experience Design for API Documentation
codejagaban
1
510
Collaborative Development with Jira and GitHub
codejagaban
1
150
Leveraging Server-side Rendering for Enhanced Web Performance and SEO
codejagaban
1
350
Becoming a developer.pdf
codejagaban
3
240
Jira and Frontend Development
codejagaban
3
270
Designing a Good Product
codejagaban
2
160
Other Decks in Technology
See All in Technology
HTTP QUERY時代の型安全な検索APIをKotlinで設計する
sansantech
PRO
1
120
「個社」ではなく「業界」の課題を解く AI 対話開発 ー 価値を広げる設計と、価値を守るエンジニアリング ー
ivry_presentationmaterials
4
830
文書画像からの情報抽出を行うエージェントを、軌跡の正解データ無しで作れるか
sansantech
PRO
2
220
AWS Well-Arhitected Frameworkセキュリティの柱 について
miu_crescent
PRO
2
170
From vibe coding to reliable (agentic) development
jcabot
0
140
NutanixへのSSHアクセスの今後について
shadowhat
0
130
IoTのデータ保存をSREの観点で考える
grimoh
1
110
サーバーラックは作る時代! 3Dプリンターで作る10インチラックのススメ
jacopen
2
490
認知負荷の減らし方 ~開発にも日常業務にも活かせるノウハウ~
minorun365
PRO
15
9.5k
IP重複は"ランディングVPC"で受け止める ― PrivateLink と Transit Gatewayによるマルチテナント接続基盤の設計
hatahata021
3
260
[関西Kaggler会 20261113] 続・コミュニティコンペのススメ
nejumi
0
190
認知の質も文化醸成も。数年取り組んで見えてきた技術広報のKPI設計 / Tech PR KPIs: Lessons on Awareness Quality and Culture After Several Years
bitkey
PRO
0
170
Featured
See All Featured
For a Future-Friendly Web
brad_frost
184
11k
Become a Pro
speakerdeck
PRO
31
6.4k
Abbi's Birthday
coloredviolet
5
11k
Building an army of robots
kneath
307
47k
Future Trends and Review - Lecture 12 - Web Technologies (1019888BNR)
signer
PRO
0
3.8k
Bootstrapping a Software Product
garrettdimon
PRO
306
120k
Everyday Curiosity
cassininazir
0
410
Performance Is Good for Brains [We Love Speed 2024]
tammyeverts
12
2k
Faster Mobile Websites
deanohume
310
32k
Why Your Marketing Sucks and What You Can Do About It - Sophie Logan
marketingsoph
0
470
So, you think you're a good person
axbom
PRO
2
2.3k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
35
2.9k