David Shevitz
@aikithoughts
Followers
758
Following
2K
Media
62
Statuses
1K
Documentation manager @Stripe. Thoughts and opinions expressed are my own, because who else would claim them? (he/him)
Everett, WA
Joined March 2009
Well, I have hardly any followers. But recent news has made me decide off off this platform. Folks who want to find me know where to find me! So long, space cowboy…
0
0
4
I always love seeing my discipline talked about like this.
1
0
2
So I became a manager to grow my skills. To learn new things. And boy am I! What I’m learning now: my IC skills don’t necessarily translate to my new role. That’s ok. It’s long past time I empty my cup. I just hope I fill it with the right things.
1
0
5
Great work from the Stripe Docs team! :D
To make it easier for developers to find the right SDK for their integration, we pulled out information that was buried on the libraries page and moved it into distinct pages. We rolled out these docs to users today. You can find the new section, here: https://t.co/rUjXrRZLsZ.
0
0
2
👕 Jersey Week giveaway 👕 @JmoSmooth13 has somethin' special for ya. ✍️ Want to win his jersey? Follow us + retweet THIS TWEET to enter—contest runs 24 hours, full rules here: https://t.co/hMWI12uEgt
10
384
262
I mean, to be clear, you can be a great developer and a great writer! Nothing wrong with that. But you’re not obligated to become so.
0
0
3
You can be a brilliant developer… …and not be a great writer. It’s okay. It’s why some of us became technical writers: To bridge the gap between code and content.
1
0
5
Fascinated that my @ouraring detected that I was under the weather. Annoyed that I tested positive for Covid. 🙃
2
0
0
Hey @AlaskaAir My wife and son have been waiting for 45 minutes for their bags and no sign of anyone’s bags get! What do they need to do for you to honor your guarantee?
2
0
0
Every time I hear my brother play, I am astounded. I simply must share his latest work. I hope you enjoy it as much as I do: https://t.co/6RlqncDtno
open.spotify.com
Matt Shevitz Quartet · album · 2022 · 9 songs
0
0
2
You have a list of 2 items. You want to introduce that list by saying: "This list contains two items:" Don't. Instead, say: "This list contains the following items:" Sincerely, A writer who adds a 3rd item and forgets to update the introductory sentence. You're welcome.
0
1
10
If you view technical documentation as a chore, or just another item to check off before launch… Hire a technical writer and listen to them. You, your development processes, and your users will be better for it!
0
0
4
Take a moment and read what you’ve written out loud. If you have to take a breath before finishing a sentence, that sentence is too long.
1
0
4
Passive voice: “The ball was thrown by Jill.” Active voice: “Jill threw the ball.” In technical writing, use active voice as often as you can. When do you not use it? For me, when the actor is unknown or hard to explain: “When foo happens, an error is thrown.”
0
1
9
Writing reminder: Whenever possible, put the focus on the user, not the feature or product. Products don’t get things done. People do!
1
2
5