Stephanie Morillo stephaniemorillo.co

A Brief introduction to technical writing

Stephanie Morillo:

Developers encounter technical writing everywhere: product & API docs, manpages, tutorials & more. We know it matters but what is technical writing exactly? And how does it differ from other writing?

In this brief post, I define what technical writing is, provide examples of technical writing in software and beyond, and explore other skills technical writers must develop to create successful and effective documentation.

The Changelog The Changelog #407

Designing and building HEY

We’re talking about designing and building HEY with Jonas Downey, the lead designer behind HEY. In their words, “Email sucked for years, but not anymore.” We were super interested in how they went about solving the problems with email, so we invited Jonas on to share all the details and a behind-the-scenes look at the making of HEY.

Opensource.com Icon Opensource.com

5 tips for making documentation a priority in open source projects

1️⃣ Value contributions to documentation just as much as code contributions
2️⃣ Put documentation and code in the same project repo
3️⃣ Make documentation a requirement for a merge or release milestone
4️⃣ Have a consistent contribution process for code and documentation
5️⃣ Have well-documented processes for contributing to documentation

That’s the TL;DR, but each of these is expanded upon in the article.

Peter Ohler github.com

A journey building a fast JSON parser and full JSONPath (Oj for Go)

Peter Ohler:

I had a dream. I’d write a fast JSON parser, generic data, and a JSONPath implementation and it would be beautiful, well organized, and something to be admired. Well, reality kicked in and laughed at those dreams.

This post lays out Peter’s plan, his journey, and his lessons learned in great details. Seems like it’d pair nicely with the recent Go Time all about JSON.

Gatsby Icon Gatsby – Sponsored

Become a Gatsby partner and accelerate your business 📈

logged by @logbot permalink

This is a great opportunity if you build sites for clients. Here’s what Brian Webster of Delicious Simplicity had to say about Gatsby’s partnership program:

Partnering with Gatsby has been a game changer for our business. We’re able to exceed customer expectations, bring in new business, and delight our developers.

Give your clients confidence as a Gatsby certified partner. Get started today.

Brain Science Brain Science #26

It all begins with empathy

Have you heard the phrase, “Put yourself in their shoes?” In this episode, the conversation focuses on the “HOW” and why it all begins with empathy. Empathy is the key that enables access to another person’s perspective and emotional state. It is also a fundamental aspect of building and sustaining relationships with others. The fascinating thing is that there are 3 types of empathy: cognitive, social, and empathic concern. Plus there’s a counterpart component called compassion that moves us to take action.

Nikola Đuza pragmaticpineapple.com

Why learn Vim in 2020?

Nikola Đuza makes a compelling case for the powerful text editor that developers love (or love to hate):

What Vim is excellent at is navigating, making some changes, and repeating the process. The process most call editing (not to be confused with writing). Most developers tend to overlook this fact, but this is one of the strong selling points of Vim. Developers are more prone to reading code, jumping from file to file, making small incisions in the code, and writing code all the time.

Browser London Icon Browser London

Apple’s move to ARM could reshape the development landscape

James Blizzard, writing for Browser London:

in my view, a number of factors are converging to make change ever more likely. Namely, the huge scale of cloud computing providers, Apple’s plans to migrate their laptop products to ARM-based processors, and the opening up of the educational space to include ARM-based systems.

There are some great thoughts from James in this article. From my vantage point, ARM is well-positioned for the short/medium-term, but RISC-V might just disrupt that for the long-term. One small piece of evidence: how Apple positioned this transition to Apple Silicon instead of to ARM.

Go Time Go Time #140

The latest on Generics

Robert and Ian join us to talk about the latest updates on generics in Go. What type of feedback are they looking for as developers get their hands on tools designed to experiment with generics and Go? What was the deal with the featherweight Go paper that also discussed generics? Why can’t we use angle brackets for generics?

The Changelog The Changelog #406

Making Windows Terminal awesome

Kayla Cinnamon, Program Manager at Microsoft for Windows Terminal, Console, Command Line, and Cascadia Code joined us to talk about the release of Windows Terminal 1.0 and the new Windows command-line experience. We talk about everything that went into rethinking the command line experience on Windows, the UX and UI design behind it all, the learnings of working in open source, and what’s to come for the Windows command line experience.

0:00 / 0:00