The Developer Advocacy Handbook

About this handbook

1. About this version
2. About the author

What is Developer Advocacy?

1. Defining Developer Advocacy
2. Start with the right mindset
3. Find your role and play to your strengths

Work with your own company

1. Prepare for prejudice
2. Deal with company changes
3. Be there for internal developers
4. Work with PR and marketing
5. Be known as an outward channel
6. Train other advocates and developers
7. Share useful technology
8. Balance your personal and official channels
9. Remove the brand

Working with your competition

1. Work with the competition
2. Show respect to the competition
3. Acknowledge when the competition is better
4. Know about the competition
5. Build examples using and trying out competitive products

Prepare for outreach

1. Get your facts right
2. Know the audience and their needs
3. Have expert backup
4. Choose the right medium
5. Plan for failure

Get speaking opportunities

1. Take part in podcasts
2. Take part in panels
3. Go to Grass Roots events
4. Go to Meetups
5. Write articles
6. Offer Brownbags
7. Ask questions at conferences
8. Be a presenter people want to invite—publish your presenter terms

Travel and conference participation

1. Getting your travel and accommodation sorted
2. Who pays what?
3. Be at the event
4. Give the event some social media love
5. Use the event to build a network
6. Keep track of your conference participation
7. Work with the conference buzz

Deliver a talk or workshop

1. Be yourself
2. Invite communication
3. Prepare takeaways
4. Plan time for and own the questions and answers
5. Be honest and real
6. Follow up communication

Delivering presentations tips: timekeeping and more

1. How will I fit all of this in X minutes?
2. Less is more
3. Your talk is only extremely important to you
4. Map out more information
5. Live coding?
6. Avoid questions
7. Things to cut
8. Talk fillers
9. Planning Your Talk Summary

Things not to say on stage—and what to do instead

1. “This is easy…”
2. “I’ll repeat quickly, for the few of you who don’t know…”
3. “Everybody can do that…”
4. “X solves this problem, so you don’t have to worry about it”
5. “As everybody knows…”
6. “This is just like we learned in school…”
7. “That’s why Y (your product) is much better than (competitor) X”
8. “This can be done in a few lines of code…”
9. “If you want to be professional, do X”
10. A quick check

Write great posts and articles

1. Simple is not stupid
2. Say what it is—don’t sugar-coat it
3. Size matters
4. Add media
5. Structure your content
6. Time-stamp your content
7. Cite to prove
8. Pre-emptive writing
9. Ending on an invitation to learn more

Write excellent code examples

1. Solve a problem with your example
2. Show a working example
3. Explain the necessary environment
4. Write working copy and paste code
5. Have the example as a download
6. Write clean and clever examples
7. Build code generators
8. Hosting code and demos

Prepare great slide decks for presentations

1. Know your stuff
2. Start with the content—not the slides!
3. Start with a highly portable format—text
4. Quick presentation creation tip: unpacking bullets
5. Pick a presentation tool that helps you present

Create great slide decks for presentations

1. Illustrate, don’t transcribe
2. Use and find images
3. About code examples
4. Sound and videos
5. Don’t bling it up
6. Keep it brief
7. Consider the audience
8. Corporate and conference templates
9. Don’t reuse without personalising
10. Share and enjoy
11. Additional presentation tips

A checklist for more inclusive, accessible and understandable talks

1. Talk materials
2. Format
3. Content
4. Tracking
5. Insurances
6. Bonus round

Keep a record of your work

1. Record the audio of your talks
2. Shoot video
3. Link collections
4. Keep a conference participation list

Know and use the (social) web

1. Find great web content
2. Redistribute web content
3. Be known on the web
4. Use powerful social web sites and products
5. Use the web for storage, distribution and cross-promotion
6. Hint, tease and preview
7. Track your impact
8. Build a network
9. Create or take part in a newsletter
10. Create or take part in a podcast

Working from your own computer

1. Get a decent setup
2. Screencasts and screenshots
3. Streaming
4. Taking part in live online chats
5. Attending live online events

Recording your own talks

1. Check your setup and your surroundings
2. Record different parts of the talk separately
3. Remember that you need to share the screen with your slides
4. Use accessibility features to add extra video value
5. Record in the highest possible quality
6. Keep originals and make it easy to get your video

Creating educational videos

1. Creating super short videos
2. Start with the script
3. Record your video and audio
4. Record a screencast of the feature
5. Sync the screencast with your audio/video

Final Words

Colophon