Slide 1

Slide 1 text

Writing @

Slide 2

Slide 2 text

Help people create and ship better software.

Slide 3

Slide 3 text

Help people create and ship better software. Teams and Individuals

Slide 4

Slide 4 text

Help people create and ship better software. Generate code faster and with less effort.

Slide 5

Slide 5 text

Help people create and ship better software. Deliver code to customers faster and with less effort.

Slide 6

Slide 6 text

Help people create and ship better software. By removing the tedious parts and letting them focus on what matters…

Slide 7

Slide 7 text

Help people create and ship better software. …and also by teaching.

Slide 8

Slide 8 text

Why write, share, and teach? ✎

Slide 9

Slide 9 text

Tools are great.

Slide 10

Slide 10 text

But having a tool isn’t enough.

Slide 11

Slide 11 text

Here’s a tool…

Slide 12

Slide 12 text

1. Freshen smelly shoes. 2. Remove static from clothing, hair, TVs, etc. 3. Clean pet hair from the floor or furniture. Now add some knowledge/ideas…

Slide 13

Slide 13 text

Here’s another tool…

Slide 14

Slide 14 text

1. Pipe frosting. Cut off a corner to use as a pastry bag. 2. Store homemade soup. Freeze in a closed bag and pile them up for space saving storage. 3. Inflate to protect precious cargo. Now add some knowledge/ideas…

Slide 15

Slide 15 text

Wildbit is great at support, but support and manuals are safety nets.

Slide 16

Slide 16 text

“If you want them to RTFM, make a better FM.” - Kathy Sierra

Slide 17

Slide 17 text

What if the “manual” was full of ideas and knowledge?

Slide 18

Slide 18 text

tt The Tools Safety Net Customer Success Customer Support Documentation Guides Newsletters Labs We’re great at support and docs, but these are reactive approaches to helping customers. We’re great at this. Without tools, nothing else matters. Blogs & Social Media Communication We’re pretty good at this, but there’s some room for improvement in increasing our reach and consistency. We’re off to a good start, but outside of our tools, these are the kinds of efforts that can really help our customers take their game to the next level. Since these are usually side projects, they’re often difficult to create and support. However, it’s important that we keep an eye out for these kinds of opportunities and begin to treat them as central to our process.

Slide 19

Slide 19 text

“I don’t have anything interesting to say.” You may not realize it, but you have a lot of interesting things to say and share. No matter what your role is, there are countless other people around the world doing the same stuff but with less experience and knowledge. Even the smallest idea/tip could be really useful and interesting to someone else.

Slide 20

Slide 20 text

“I’m not a good writer.” There’s only one way to get better. But until then, don’t worry about it. You’re surrounded by a whole team of people who can help. Get your thoughts out in words, and we’ll all do the rest.

Slide 21

Slide 21 text

“I don’t know what to write about.” Talk to the team. It’s sometimes difficult to recognize the really cool knowledge that you have because you already know it. Somebody on the team can help you see the ideas and topics that may not be obvious to you but would be very interesting to others.

Slide 22

Slide 22 text

Process

Slide 23

Slide 23 text

Idea ✒ Write Refine ⚑ Edit Produce Promote Illustrate Publish Review ⏲ Schedule Editorial Calendar & Workflow Paper Illustrating or creating visualizations of any kind for posts is a fluid process depending on whether they’re decorative or based on sketches or graphs generated by the author. The general rule is that the sooner we start on them, the better.

Slide 24

Slide 24 text

Idea ✒ Write Refine ⚑ Edit Illustrate Paper We keep a list of ideas in Trello. This way, we can all discuss and prioritize topics collectively. Ever need an idea for something to write about it? Voila. The idea list. Use any tool or format you’re comfortable writing in, but so far Paper has worked pretty well for collaboration, so it’s not too bad as a writing tool as well. Early on, any topic needs refinement. This is less about editing and more about getting the structure and key points nailed down early so that editing is just about semantics. The less refinement we do after this, the smoother the process goes. For example, if you’re writing about a technical topic, you’ll want to have a team member with knowledge of the topic check for technical accuracy and provide relevant technical feedback. Once we’re at editing, hopefully it’s just typos and phrasing. Editing should still be managed through paper because editing in Craft is more difficult, and the process of moving content back and forth is error-prone.

Slide 25

Slide 25 text

Illustrate Production is primarily about migrating the content from Paper, or wherever, into Craft. This is where we’ll mix in pull quotes, add images and captions, and get the layout right. Ideally, there’s no more editing needed at this point. Sometimes, things will get out of whack going from the written medium into Craft. Fixing typos and markup can break things, and it’s important to have a final review to make sure all of the links work, the images have good captions, and everything else is perfect. With more and more articles to publish and a goal of making sure that all of the sites are current with the latest news, we’ll need to coordinate and schedule different posts to be published at different times for the best exposure and to not overwhelm the publishing process. Publishing is the easy part, but it’s just the beginning. Produce Promote Publish Review ⏲ Schedule Promoting is where the real work comes in. Depending on the content, we’ll promote it via Twitter, republishing on Medium, our product guides and blogs, or email newsletters.