The past two weeks, I created a Slack channel called #vale-at-red-hat and invited folks at work to join. Then I invited them to become collaborators on the repo. It worked! A bunch of folks signed up to become full collaborators. To work this way, you have to give up sole ownership and control. Invite folksContinue reading “Vale: The unexpected team”
Author Archives: Rolfe DH
Vale notes #3: Things start rolling
Last week, I did separate walk-throughs with two writers. My intention was to gain insight into the issues a typical user might encounter, and to use that information to improve the “getting started” repo I had created. I helped them install, configure, and start using Vale on their systems. Installing Vale by using brew wasContinue reading “Vale notes #3: Things start rolling”
Vale notes #2: Talk to experts and stakeholders
In addition to eating my own dogfood, I started finding and talking to experts and stakeholders. For experts, I went to folks inside and outside Red Hat. At Red Hat, I talked to Fabrice Flore-Thebault and Yana Hontyk. Last year, they presented on using Vale with their documentation sets: Eclipse Che and CodeReady Workspaces. IContinue reading “Vale notes #2: Talk to experts and stakeholders”
Vale notes #1: Eating my dog food
I’ve heard complaints about the peer review process at a variety of organizations where I’ve seen it in use. To simplify, they sound like this: Writers: When I fix a set of issues and resubmit the PR, the reviewer(s) come up with a new set of issues. Reviewers: I keep flagging the same set ofContinue reading “Vale notes #1: Eating my dog food”
Git rid of old branches :-)
Every so often, I clean up old working branches I don’t need any more. After I’ve written or revised content, and the pull request has been merged from my fork of the repo into the main branch of the organization’s repo, it’s time to get rid of the old working branches. TLDR/Copy and paste Here’sContinue reading “Git rid of old branches :-)”
Using voice to text to write blog posts
I am sitting in our car with the dog while my wife has gone into the food store wearing a mask to buy groceries. I’m experimenting today to see how well writing a blog post using voice-to-text on my phone works. As far as I know, there aren’t any good inexpensive or free ways toContinue reading “Using voice to text to write blog posts”
Job aid: Git cherry-pick a commit and manually resolve a conflict
This post is short version of Git: Cherry-pick a commit into a branch and resolve a merge conflict. Replace `upstream/enterprise-4.8` with whatever your target branch is. I copy/paste these commands into my terminal. Verify that “Your branch is up to date with ‘upstream/enterprise-4.8’.” Go to the pull request that has the merge failure (e.g., like thisContinue reading “Job aid: Git cherry-pick a commit and manually resolve a conflict”
Saving Lives With Checklists | Heroic Technical Writing: Advice and Insights on the Business of Technical Communication
checklists serve the following functions. Act as memory guide. Ensure that all critical actions are taken. Reduce variability between pilots. Enhance coordination during high workload and stressful conditions. Saving Lives With Checklists | Heroic Technical Writing: Advice and Insights on the Business of Technical Communication
Simon Sinek: How great leaders inspire action | TED Talk
Git: Cherry-pick a commit into a branch and resolve a merge conflict
Here’s the merge conflict message our merge master got when she tried to cherry pick my pull request (PR) to version 4.7 of the published OpenShift docs (lines , below). Here, I start by deleting the enterprise-4.7 branch (line ) because it had a previous unmerged commit sitting at the top of the pile. (InContinue reading “Git: Cherry-pick a commit into a branch and resolve a merge conflict”
