Garrett AlleyBuild Your Team Like You’re Planning a HeistThink about building a team for a heist. I think this is a great exercise for managers. Think of all the effort that goes into the planning…Feb 28, 2023Feb 28, 2023
Garrett AlleyWhere to Spend when Building DocsHere’s the thing: you’re going to spend money on documentation regardless of your approach. You need to understand that, and your options…May 27, 20221May 27, 20221
Garrett AlleyRemoving Friction from the Documentation Feedback ProcessIt’s important to make it as easy as possible for customers and anyone else reading your documentation to provide feedback.Dec 15, 2021Dec 15, 2021
Garrett AlleyLessons Learned from a Failed Documentation Site LaunchSometimes we forget how complex a process standing up a new Documentation site can be. 3 things I wish I’d have known going in.Nov 22, 20211Nov 22, 20211
Garrett AlleyWhen to Choose Docs as CodeYou may hear people talk about a (somewhat) recent approach to documentation called Docs as Code. In a Docs as Code (DaC) setup, you treat…Apr 15, 20201Apr 15, 20201
Garrett AlleyEmail Address Convergence (Or, Why Am I Getting Strangers’ Email?)There are over 1.5 billion Gmail accounts (https://www.statista.com/statistics/432390/active-gmail-users/). That’s like twice as many…May 24, 2019May 24, 2019
Garrett AlleyinDesign and Tech.CoSetting up a New Tech Pubs Department: DeliverablesSo, you joined a startup (or somehow inherited the Documentation function at your place of work). You realize that professional…Apr 29, 2019Apr 29, 2019
Garrett AlleyinDesign and Tech.CoHow Our Documentation Team Uses SlackFirst things first, yeah, I know that using Slack is hardly a revolutionary idea. It’s been around long enough that just about everyone…Apr 22, 2019Apr 22, 2019
Garrett AlleyinDesign and Tech.CoGetting Started with Documentation: Hiring Your First Writer(This is, basically, a continuation of my first article on Startups and Documentation. You don’t need to read that one first, but I think…Mar 20, 2019Mar 20, 2019
Garrett AlleyinDesign and Tech.CoMigrating Documentation off of Zendesk GuideWhether you’re a fan of Zendesk’s Guide or not, you may eventually find yourself migrating your content to a different platform.Feb 27, 20191Feb 27, 20191