I've spent the last month and a half involved in performance reviews and employee calibration, so I've had a lot of time to reflect on what success looks like for myself and for the people I manage.

In this issue, you'll see how taking on thankless chores will positively affect your career trajectory, even if you are not immediately rewarded.

But first you'll play with a tool that lets you query your operating system using SQL rather than remembering a bunch of separate command-line tools. I learned about this tool years ago and recently rediscovered it. I'm excited for you to give it a try.

Unlocking Your System's Secrets with OSQuery

Command-line tools always make me smile. I love using small, useful utilities to solve problems, but I've found it even more fun to build my own tools. The Go programming language is one of the best ways to build these tools because you can create self-contained executables for multiple platforms. In this issue, you'll see how quickly you can build a tiny Go CLI app by building one that serves a directory over HTTP, even if you've never used Go before.

Education myths make me frown, though, because they make it harder on learners and teachers alike. One of those myths is the Learning Pyramid. You've heard of it, and if you've ever done content, you've had someone else tell you how some things are "better" than others for retaining information. Like learning styles, it's another myth without scientific backing. Read more to learn why.

The Myth of the Learning Pyramid

You've heard this before:

You want to grow your career, but those conversations with your manager might not come naturally to you, so in this January issue you'll find some advice on how to get those going. Then you'll explore a tool that makes looking at file changes easier on the eyes.

Advocating for Yourself with your Manager

If you don't advocate for yourself, nobody else will. Your manager has a ton of other things on their plate and your professional development might not be on it. Good managers are going to ensure that professional development is part of your regular discussions, but not every manager has the training or the desire for that.

No matter what kind of manager you have, you're going to have to bring things up yourself. Here's my advice on how to ask for what you need.

In this issue, you'll see how you can navigate the first three months of a new role and look at three HTML elements you can use to mark up changes in documents. Then you'll see some strategies you can use to create a better experience for people who might not be excited about learning what you have to teach.

With this issue, the newsletter is now two years old. Thanks for your support. I'm looking to grow the subscriptions to this newsletter in 2024; I'd appreciate it if you could share this issue with your friends and colleagues who would benefit from this content.

Navigating Your First 90 Days.

When you join a new team, you want to put your best foot forward and make a good impression, but you also want to set yourself up for long-term success. I've built two teams from scratch over the last 5 years, and every new member has asked me how they can be successful in their first few months. Here's what I advise my new team members to do as they get up to speed, and this is the advice I've followed at almost every place I've joined.

I've been writing, presenting, and teaching my entire career, even when it wasn't my primary job. I created tutorials using Microsoft Word and converted them to PDFs, and I used PowerPoint and Keynote when I did slides for conference talks. But those tools always got in the way of the content creation process. And despite my using HTML for ages, it also never felt right. So I looked into text-based methods like DocBook, which I actually like, but that required a lot of XSLT knowledge.

This quote from The Pragmatic Programmer always stuck out to me:

As Pragmatic Programmers, our base material isn't wood or iron, it's knowledge. We gather requirements as knowledge, and then express that knowledge in our designs, implementations, tests, and documents. And we believe that the best format for storing knowledge persistently is plain text.

Plain text is terrific. It's always going to work, but it always seemed so limited compared to what people expect.

In this issue, you'll look at how scheduling your work helps you focus on the right tasks so you can focus on what matters, and you'll explore the stages authors go through when developing a large project like a book so you can identify those when they start happening to you.

But first, I'll share a quick shell trick I use when working with Git repositories on the command line interface.

Jump to the Repository Root

If you're working on a project in the CLI and you've navigated to a subfolder, you might want a quick way to navigate back to the project root. You can use a combination of pushd and popd to jump around your shell, but there's a faster way if your project is a Git repository.

Hello friends.

This month, I want to focus on an area of professional growth I've seen some people struggle with recently, and I'd like to see you avoid that struggle. As you navigate your professional journey, you'll encounter the challenge of adapting your tried-and-true "playbook" to new situations. This can go horribly wrong if you don't consider the factors that made your playbook successful. In this issue, you'll see the pitfalls you can run into and how you can adapt.

But first, I'll share a tool I've been using to track my time on projects right from my Terminal window that I think you might find helpful if you're in an environment where you need to be accountable for your time at a more granular level.

Tracking Time with TimeWarrior

Hello, friends!

In this issue, you'll see three things that can help you work smarter and faster. First, you'll see how you can get ready to do the work you need to do each day by explicitly setting aside time to plan the work. Then you'll see the one command-line trick I use every day that I can't live without. Finally, you'll see how you can help your learners stay engaged in workshops or classes you're facilitating.

Incorporating Prep Time Into Your Day

Work comes at you fast.

Hi friends. This month's issue will be slightly shorter than others; I spent the last couple of weeks under the weather, so I've been catching up on many fronts, but I still wanted to get a couple of pieces of content to your inbox.

I've had several conversations with people who have been frustrated by the lack of growth in their careers, and it got me thinking about how I never really understood how promotions worked until I became a manager and had to help my direct reports get through that process. In this issue, you'll see a few reasons why you're not getting promoted and hopefully gain insight into what you can do about it.

In addition, you'll see how you can apply adult learning theory to your content.

Let's get into it.

If someone's ever told you that you need to get to the point faster or that your answers are too shallow, this newsletter issue is for you. In this issue, you'll see how to give concise answers that provide the right level of detail.

Then you'll learn about Campbell's Law, which has nothing to do with soup, and everything to do with how focusing too hard on a metric can lead to poor results. Finally, you'll look at a tool that lets you respond to file changes. It's one of my all-time favorite tools, and I'm excited to introduce it if you've never heard of it.

Let's dive in!

Give Stronger and Clearer Answers in Interviews and Beyond

Hi friends.

It’s May, and I’m thinking back to my teaching years, watching my students graduate and move on to start their careers. I remember how hard it was for many of them as they competed for a handful of jobs in the area. It got me thinking about advice I used to give them, and I’ll share a little of that in this issue.

I’m also excited to share a little CSS library I’ve been using on a project I’m building. I’ve been frustrated with the state of CSS lately, and this library came at just the right time.

Let’s get into it.

The end of April is always an interesting time for me. I often spend the first part of my year figuring out the priorities and goals for the year while also preparing for income tax payments. Usually, I feel good by this time of year because I’ve got plans in place and taxes are done.

But this year is different. Because of layoffs and job insecurity, a lot of my friends are worried and are asking for advice. I feel uneasy.

I’ve had more than 30 conversations about compensation this year. They’re all asking some of the same questions that made me realize that there are probably a whole lot of other people who don’t understand how compensation works. I’m not an expert here, but I do have a lot of takes here that I’ve decided to share in this newsletter in the hopes that I’d have something I could point folks toward as a resource in the future.

Unlike other issues, this is the only topic this month because it applies to everyone reading this, whether you create code or content.

Happy Spring! Some folks are closing out the first quarter of 2023, and others are wrapping up their taxes. But many are talking about ChatGPT. I’ve got a lot of opinions myself, but in this issue, I’m going to share a few ways you can use it right now to do some tasks faster, along with some warnings to keep in mind. I’m also excited to share a tool I’ve been using to copy files securely between computers with different operating systems without installing servers or worrying about permissions.

Using ChatGPT to Work Faster

ChatGTP is on many people’s minds. To some, it’s the greatest invention in years. To others, it’s a terrifying tool that’s already eliminating jobs. I’ve seen it solve some problems well, and I’ve seen it write the most useless, surface-level nonsense I’ve seen in ages.

I’ve got my concerns about ChatGPT and other AI tools, especially since this tool seems to be at the “peak of inflated expectations” on Gartner’s hype cycle. Still, I will save a lot of time and space here because the reality is that these various AI tools exist, and we have to contend with them, so it’s worth looking at leveraging them like you would any other tool. It’s a good bet that your peers already are.

Hi friends. February draws to a close, and it’s been a busy month. A couple of weeks ago, my former team was laid off, and since then, I’ve been networking with folks to help these fantastic educators and technical writers find new jobs. The outpouring of support has been incredible, and I’ve learned that while many companies are doing layoffs, there are still quite a few smaller companies hiring.

I’m starting this issue with a handful of reasons that you should be interviewing for jobs even when you have one because one of the best things you can do for your career is to be proactive about your job search. Then I have a couple of tools to share with you: one to help with your writing and another to help you share your local development work with others so you can get feedback.

Let’s dive in.

Interview While You’re Happy

We’re one month into the new year, and for many, that means annual review time. I’m preparing for it myself, writing my self-evaluation, an evaluation for my manager, and evaluations for the team I support. This month I want to share the model I use to do my self-evaluation and make sure I don’t leave certain things out.

I also want to show you a tool that’s helpful for both content creators and software developers that lets you create diagrams using a plain text markup language.

Let’s dive in.

Build a Strong Self-Evaluation

It's the last issue of 2022, and it's been quite a ride. But rather than do the usual "look back at the year," I'm bringing you three fresh articles in this last issue, and I hope they're helpful. First, you'll look at some tactics to help find work in a slow job market, and then you'll explore two command-line programs that can help you free up disk space. And finally, I'll try to convince you to rethink using "we" in your technical tutorials.

Also, you'll notice this newsletter looks a little different. I've moved to Buttondown, and I'll be making some changes to where messages come from and where the archives are stored. Please bear with me as things roll out between now and the next issue.

Let's go!

Finding Work in a Down Market

Hi friends.

In this issue, you'll find some questions you can ask your potential teammates to see what the team culture is like so you can make a better decision when interviewing. You'll also explore a new tool for interacting with APIs from the command line interface that I'm really excited about. Finally, this newsletter is going to move to a new home, so please read on to learn about that.

Assessing the Team During an Interview

Interviewing for a job is a two-way street. You're looking for a company that will pay you for your skills and experience, so it's natural for you to spend most of your time selling potential employers on your skills and experience. But remember that interviewing is a two-way street, and if you're going to spend a minimum of 40 hours per week with this team, you need to know what you're getting yourself into. The company itself might be great, but you want to make sure there's alignment with the team and how you want to spend your time. Plus, the team and its manager have the most significant impact on your day-to-day happiness.

Hey friends. I'm excited to share this October issue with you because it covers a topic I've been thinking about for most of the year, and I'm ready to start discussing it more widely. In this issue, I hope to convince you that there’s a better way to think about the delivery methods you use when creating educational content.

I also want to share with you some reasons why perfectly qualified candidates don't get the job. I've done a fair amount of research this month, which took some extra time, so this month's newsletter will only have two articles instead of the usual three.

Let's jump in!

Rethinking Delivery Methods

Hi friends!

It’s Fall in the United States, and here in Wisconsin, the leaves are changing color and falling from the trees. The air is drier and colder, and it’s almost hockey season. It’s also the end of the month, so here’s the September issue.

In this issue, you’ll explore how to tell if you’re being pushed out of your role, how to make your writing and teaching more inclusive through the words and phrases you choose, and how to add notes to your Git repository.

Warning signs that your job is in danger

Ah, late August. In Wisconsin, it's the time of year when kids are gearing up to head back to school, football is gearing up, and the realization that the weather is about to start getting colder.

Summer is winding down, but this newsletter is just getting started. This month's issue introduces a new command-line tool you might find useful, explores effective marketing, and shares some advice about effective résumés based on my experience as a hiring manager and some patterns I’ve seen.

Let's go!

Marketing is good and good for you.