Using Google Slides and icons to diagram the Google Android API Intro

Earlier this week, I went to the San Francisco Write the Docs meetup and heard eleven great lightning talks. I heard many ideas I want to try out (like playing with Twine, for example), but I am very visual, so the icons John Mulhausen used in the Kubernetes Case Study caught my eye, and I decided to play with those first.

Briefly, John is using GitHub to allow other tech writers to help him with the Kubernetes documentation. It’s open source, so anyone can contribute by making pull requests. John particularly needs help creating diagrams, so he demonstrated how to use an obsolete Google style guide to create new diagrams.

It happens I was researching Google Android APIs today. I decided to turn the developer guide introduction into diagrams, using John’s style guide. The result is the Google Slide Deck above. (I did create one icon, using the same color and style, so it meshes with the rest of the icons. See if you can figure out which icon I created.)  Continue reading “Using Google Slides and icons to diagram the Google Android API Intro”

Git Version Control — Step-by-Step

In Using Git for Website Version Control I talked in general about how I use Git to manage development of my website. In this post, I’ll show you the process step-by-step.

Overview

To update my website (which I developed using HTML, CSS, and a little JavaScript), I edit the files on my laptop, and then copy (FTP) these modified files to the server. On my laptop, Git lets me make changes on a copy of my website. Ideally, smart use of Git gives me the ability to discard experimental changes and return to an earlier version.

Here is the process I use.

Step 1 — Tell Git I will be making changes

The first thing I do is open the command line (GitBash) and navigate to the GitHub folder for my website. (I use GitBash because I’m using Git for Windows.)

starting up gitbash

Next I open my development branch. This tells Git I will be working on a copy of my files. Continue reading “Git Version Control — Step-by-Step”