FOSS DOCS 101
Mikey Ariel
Senior technical writer, Red Hat
EuroPython, July 2015
Slide 2
Slide 2 text
EuroPython 2015 | MIKEY ARIEL
who am I?
Slide 3
Slide 3 text
EuroPython 2015 | MIKEY ARIEL
why am I here?
Slide 4
Slide 4 text
EuroPython 2015 | MIKEY ARIEL
documentation matters!
(to me, to you, and you, and you...)
Slide 5
Slide 5 text
EuroPython 2015 | MIKEY ARIEL
times are a' changing...
Documentation is a key component of
successful software
Documentation is an afterthought of
software delivery
Slide 6
Slide 6 text
EuroPython 2015 | MIKEY ARIEL
how documentation helps
Unified and intuitive
user experience
Portable and adoptable
workflow
Scalable and adaptable
project
Slide 7
Slide 7 text
EuroPython 2015 | MIKEY ARIEL
join the docs club
Content Strategy
DevOps for Docs
Community Engagement
Slide 8
Slide 8 text
EuroPython 2015 | MIKEY ARIEL
asking the right questions
(even if the answer is as simple as 42)
Slide 9
Slide 9 text
EuroPython 2015 | MIKEY ARIEL
WHO
are my readers?
Slide 10
Slide 10 text
EuroPython 2015 | MIKEY ARIEL
WHAT
do my readers want to know?
Slide 11
Slide 11 text
EuroPython 2015 | MIKEY ARIEL
WHEN
do my readers need this content?
Slide 12
Slide 12 text
EuroPython 2015 | MIKEY ARIEL
WHERE
do my readers consume this content?
Slide 13
Slide 13 text
EuroPython 2015 | MIKEY ARIEL
WHY
do my readers even need this content?
Slide 14
Slide 14 text
EuroPython 2015 | MIKEY ARIEL
GNOME help
Slide 15
Slide 15 text
EuroPython 2015 | MIKEY ARIEL
GNOME help
Slide 16
Slide 16 text
EuroPython 2015 | MIKEY ARIEL
GNOME help
Slide 17
Slide 17 text
EuroPython 2015 | MIKEY ARIEL
GNOME help
Slide 18
Slide 18 text
EuroPython 2015 | MIKEY ARIEL
GNOME help
Slide 19
Slide 19 text
EuroPython 2015 | MIKEY ARIEL
archlinux wiki
Slide 20
Slide 20 text
EuroPython 2015 | MIKEY ARIEL
archlinux wiki
Slide 21
Slide 21 text
EuroPython 2015 | MIKEY ARIEL
RHEL OpenStack
Slide 22
Slide 22 text
EuroPython 2015 | MIKEY ARIEL
RHEL OpenStack
???
Slide 23
Slide 23 text
EuroPython 2015 | MIKEY ARIEL
DevOps for Docs
(not just for developers anymore!)