Slide 1
Slide 1 text
No content
Slide 2
Slide 2 text
Twitter: @bethanyjep
Scaling Open-Source
documentation with AI
Slide 3
Slide 3 text
Twitter: @bethanyjep
Bethany,
Jepchumba
Cloud Advocate, Microsoft
Scaling Open-Source
documentation with AI
Slide 4
Slide 4 text
Agenda
LLMs as a Service
Agents as a Service
Scalability as a Service
Slide 5
Slide 5 text
What’s harder;
writing great code, or
writing great documentation?
Slide 6
Slide 6 text
Goal
Clear, accurate, and up-to-date
documentation
struggles
maintaining robust documentation at
scale is often resource-intensive,
manual, and challenging
Slide 7
Slide 7 text
Where does AI come in?
Slide 8
Slide 8 text
No content
Slide 9
Slide 9 text
LLMs as a Service
Slide 10
Slide 10 text
Scenario
A ton of empty doc pages
with some understanding of
the codebase, how could we
make it to 100%
Slide 11
Slide 11 text
Goal
Clear, accurate, and up-to-date
documentation
struggles
One maintainer
Widely used across presentations
Not enough technical depth on the project
Slide 12
Slide 12 text
Prompty
a language agnostic asset
class for creating prompts
and managing the responses.
https://aka.ms/prompty
Slide 13
Slide 13 text
Agents as a Service
Slide 14
Slide 14 text
Scenario
Docs are now complete; how do
we streamline management of
the repo?
Slide 15
Slide 15 text
Goal
Streamlined and well-maintained repo
management workflow
struggles
One maintainer
Widely used across presentations
Not enough technical depth on the project
Slide 16
Slide 16 text
No content
Slide 17
Slide 17 text
No content
Slide 18
Slide 18 text
Scalability as a Service
Slide 19
Slide 19 text
Scenario
Okay, what about scale? How
do we ensure the docs are
reusable by our audience?
Slide 20
Slide 20 text
Goal
Localized and accessible docs
struggles
Over 15k downloads
Used globally by people from all over
the globe.
Slide 21
Slide 21 text
automate translating
Markdown files and images
containing embedded text
into multiple languages
https://github.com/Azure/co-op-translator
Slide 22
Slide 22 text
THANK
YOU!
@bethanyjep
Slide 23
Slide 23 text
THANK YOU!
Twitter: @bethanyjep
Slide 24
Slide 24 text
Colours
Typography
#04FF00 #8C5BFE #FFDA00 #FF0000 #FF9D00
Google Sans
#FFFFFF #1E1E1E