MSML

Usual disclaimer on me never updating this. 1239 days is a bit of a gap.

So, some catch up: I went back to school for a second master’s degree in 2023. A bit about that.

The MBA program I finished at WGU in 2022 overlaps the school’s MS in Management and Leadership program with three classes in common. That meant I would have six classes and the capstone project to get a second degree. The basic difference between the MSML and the MBA is the MSML is more soft-skill stuff around leading teams, innovation, and strategy. The MBA is more core business school stuff like finance and accounting, plus classes on project management and a taste of the leadership stuff. I liked the MBA, but figured as a manager of people, I could probably use more leadership work in a structured way.

I’ll be honest: I learned a lot of good stuff in the MSML program, but it was nowhere near as good or as challenging as the MBA. Part of the reason I did this back-to-school thing last year was I didn’t want my brain to go to mush, and crossword puzzles only do so much. I also needed to challenge myself and do something hard that I didn’t think I could do. Taking finance and accounting with absolutely zero background in either was a really big boulder to roll uphill. Getting past that gave me a real sense of accomplishment.

The MSML? Not so much. The most challenging courses were actually deep-dives on a couple of the most tedious classes in the MBA. One of the “tough” classes, Business Acumen, was basically a junior version of accounting, finance, econ, and marketing rolled up into one course. Two of the harder classes, Strategic Management and Change Management, had so much overlap, the papers gave me a constant “didn’t I just write about this?” situation. And this degree had zero math or Excel, but it had two classes that required a recorded presentation, three that involved Powerpoint, and it had a team project.

So, there were two proctored tests, twelve papers total. That included the capstone, which was pretty eh. In the MBA, the capstone project was really cool. You played this simulation where you ran a business, competed against other players, and then did everything from pitch for venture cap to write a shareholder report, That was a lot of fun, to be honest. The capstone for this was an annotated bibliography of three sources per class and what we learned from them, which was mostly tedious; then a giant paper on a training plan; then a speech on that paper. A lot of the papers in this class were pure tedium. A lot of people in this program are in HR, so maybe that’s the point.

The one unusual thing about this degree is I ended up working on it in six different countries. I was either cramming for tests or working on papers in Iceland, England, Qatar, India, and the UAE. I particularly remember being up all night in Dubai, sitting in an airport lounge and downing as many free Diet Cokes as possible while pulling articles for that bibliography.

I hate to sound bitter about the experience; I was mostly exhausted by it. I did learn a lot, although I think quantifying that is a bit out of this silo and bleeding into the Work Jon silo. But I did pick up some stuff that will be useful in my career. I guess it just didn’t challenge me enough. I think I really phoned it in here, and part of it was the return to office, along with the travel. I finished the degree in four months, and probably put half the effort into it that I did last year.

Another thing… So, I would not say I was in a great place in 2022, for various reasons I won’t go into here. And as I worked through that in 2022, I also worked hard on the MBA, and the two were very intertwined. So it was surreal sometimes to be sitting in a Hilton in Bangalore in 2023 which looked identical inside to the hotel I was at in Denver in 2022, like down to the same paintings on the walls. And I’d be staying up late alone, working on the same kind of papers in the same templates and the same online library and the same learning system, listening to the same albums, and thinking back to the last summer and thinking I really don’t need to be thinking about the last summer. There’s a much bigger essay about nostalgia that needs to be written in short order, but let’s just say that whole thing was disturbing. And the good news is it is probably so disturbing because I’m in a much better place now and don’t want to be in 2022, or 1992, or 2002, or whatever else.

Another thing about this degree that was a big spoiler alert on the future: the AI situation. For the MBA in 2022, ChatGPT was not a thing yet; I think it launched the month after I graduated. But it was in full swing for the MSML in 2023, and Reddit was rampant with posts about people who were throwing the syllabus and notes into ChatGPT and asking it to write the papers for them. There were also counter-posts about how ChatGPT was making stuff up like fake citations and hallucinatory text. The school used an anti-plagiarism system for papers, but it wasn’t new enough to catch ChatGPT yet. The rumor was that these systems would start using AI to detect AI though. That’s a fun little arms race that has obviously ratcheted up a bit in the last three years. More on that in another post, I think.

MBA

I would say it’s time for my annual update, but it’s like a year and a half now.

I actually started typing this from 40,000 feet above the Pacific Ocean, on my way to Maui last November, where the plan was to not think about technical writing, management, or work for seven days. I did okay with that, and feel free to bug me about my Maui restaurant list if you’re headed there. Thanks to Git, I started work on this while I was on the plane. That always seems to be the example they give in Git training, right? “So it’s all in your local repo. If you get on a plane and aren’t on the internet, you can still work.” Right? Well, I never pushed my commit, and I never finished writing, so maybe it’s not perfect.

The big update: I completed an MBA last year. This was at Western Governors University, which has a fully-remote, proficiency-based program. It’s a neat model for learning; basically, you enroll by the term, but then you finish classes as slow or as fast as you want. So instead of like enrolling in twelve credit hours for a semester, you do as many classes as you want to finish in six months.

I still worked full-time (or more than full-time, really), but I type fast. I was able to finish the two-year program in about five months. I started on June 1, and my graduation date was officially October 24, although I finished my last class about a week before that.

This program was an IT Management version of the MBA, so it contained a few courses specific to IT project management. But otherwise, it had all the same classes as a regular business MBA. (I think I skipped an operations management class, and a public speaking class, which was good. When I was an undergrad and had to take a speech class, I did it at 8 am in a summer session, so it was only six people.)

I think the first question people ask me is, “Why?” I know I don’t know any other tech writers with an MBA, and I have never applied for a job that required one. But I had a few thoughts about why I wanted to do this:

• I am a manager, and I never had any formal training as a manager. I have spent some time on Udemy watching leadership videos, and I have a whole shelf of half-read management books. But I felt like I needed something that said I was a manager, or at least something more than the few Agile crash course certification badges on my LinkedIn.
• I’ve always vaguely wanted a graduate degree, although never knew how that would happen.
• I don’t intend to move on to being a CTO or a PM or anything else. But I could see a future someday at some other company where another department got shoved next to the tech writing department (UX? research? QA?) and I would need to manage both. And I’d like to be prepared for that.
• I’m not starting a company. But in working at a start-up, I’m constantly inundated with discussion about financing and organization and whatever, so maybe I need to know more about it.
• This was way outside my wheelhouse. It would be hard. And I need to do things outside my wheelhouse that are hard.
• It’s arguably more interesting than doing crossword puzzles in my spare time to keep my brain from turning to goo.

The basic summary of the classwork is that things fell into three buckets:

• Classes that were things I do every day without thinking, or have been trained on to the point of absurdity, and I just needed to get them done quickly. There were leadership, ethics, and people management classes in which more than 50% of the content was the mandatory training I have to take every year that says you shouldn’t bribe a foreign government.
• Classes that were interesting and fun. I took a marketing class where I had to write a marketing plan for releasing Taco Bell menu items in Japan. I also liked the IT classes, which involved things like doing a SWOT analysis for a company to pivot its IT infrastructure to the cloud.
• Classes that were climbing K2 without oxygen. I never took any business as an undergrad, and had to face three classes that almost ended me: accounting, finance, and econ. These were classes with math, equations, ratios, and lots and lots of raw memorization of hundreds of terms.

The capstone project, the big thing at the end, was a lot of fun. It basically put everything together and you had to run a business in a simulation for three quarters, competing against other people. A lot of people complained that the situation was insane, but it was honestly like playing Roller Coaster Tycoon for a grade. You had to run a bicycle company and decide on everything: factories, distribution, stores, bike features, R&D, marketing, everything. You had to pitch for venture cap after the first two quarters (which meant I did not avoid public speaking), and you had to write a shareholder report. It was fun making changes to see if I could increase output or sales.

Overall, the degree had five proctored tests and seven papers which totaled about 190 pages. There was some PowerPoint, and far too much Excel. Almost everything else was Word.

(Side note: I do not like Excel. Even worse than using it for legitimate purposes like accounting, I am really not into the standard use in tech writing, which is, “Let’s do a doc plan or analysis by pouring every filename into a sheet that is immediately obsolete and then putting a bunch of random checkmarks and notes and names in 17 columns, and then in a month, we will have no idea why we did this.” If you’re in that situation, use Jira. If you can’t use Jira, use Airtable. If you can’t use Airtable, you’re probably wasting your time on something that doesn’t matter and should stop.)

The last time I wrote an academic paper, I think I had to find things in a physical card catalog and then ask a librarian to pull the microfiche for me and pay ten cents a page to photocopy the article. Everything has changed 100%. OK, I use Word (begrudgingly) and get that part. But I’d never used a reference manager to track my citations, and that all magically works, without me remembering where the parenthesis go on an APA7 cite. The course was all e-books, and the papers I had to look up and cite were all online in their library. So, search “Jack Welch GE leadership traits” and find a result in Harvard Business Review, and there’s your PDF to skim. Find what you want, and there’s a link next to it with the cite. Copy and paste it exactly and you’re up against a plagiarism checker that will nail you for doing that. It was all completely different than when I would pay my girlfriend’s roommate to type my papers on a Brother word processor for me.

So, what did I learn? I don’t know how much of this applies directly to being a tech writing manager. But I think for a person living within the wheelhouse of big tech and seeing finance and business in the news, it’s invaluable. Just in general, I think it’s twisted my brain on how companies work. The second that Albertson’s/Kroger merger was announced, I pulled 10-K reports from the SEC for both parties, drilled down to the balance sheet, and started asking my better half (the consumer packaged goods expert of the family) dozens of questions, like “why does Kroger have almost two billion dollars of cash on hand during a pandemic?” From a practical perspective, I think I knew a lot of the IT management stuff like budgeting and SWOT analysis, but it was nice to do it on paper, and the next time I have to do a major tooling acquisition, I know how to make it look.

WGU was great, too. I love the model, and everyone I worked with was awesome. I talked my sister into going back for her Master’s degree in the education school. And spoiler alert, I’m actually halfway done with another degree. More on that later.

Liquid code blocks in Jekyll posts

This came up in the factorials post I did recently, and it was a bit maddening, so here’s a quick reference, so I remember it two years from now when it comes up again.

Typical fenced code blocks in Jekyll (and any other Markdown situation) are surrounded with lines that are nothing but a triple backslash. (Your Markdown processor might also define a code language on the first line, so throwing a json on there might give you pretty formatting or color-coding, depending on your tools.) Example:

{
  "book": {
    "title": "Infinite Jest",
    "author": "David Foster Wallace"
  }
}

Here’s what that looks like in my editor:

Now let’s say you need to add an example of some code using the Liquid template language, as one might need to do when talking about Jekyll themes. When you get into your first full block of code with things like surrounding page.title with two curly brackets on either side of it, Jekyll’s going to start evaluating the code, even if it’s inside a block or a piece of inline code (hence me describing page.title with two curly brackets on either side of it instead of showing it). Liquid code takes precedence over any Markdown escaping.

Liquid has a set of tags named raw and endraw to solve this. You can use these to surround a code block containing Liquid. The nesting is really touchy though, and there’s a good chance your editor’s preview won’t show it right.

Two quick examples: First, you can put an inline example on a line. The output looks like this: {% assign n = 20 %}.

Output of a fenced code block looks like this:

{% assign result = 1 %}
{{ result }}

Here’s what these look like in my editor:

Your mileage may vary; like I said, this is touchy. Make sure to fire up Jekyll locally and test it. Bad combinations will show up as errors in your server output.

GitHub Pages Custom Domains

I moved this site from Wordpress to GitHub pages a few months ago, and when I got to redirecting the domain, I punted and put an .htaccess file on the old site and 301’ed it over. That almost worked, but after each redirect happened, any old URLs were sent to jkonrath.github.io/, which broke all of my old links. I needed to properly point my hostname to the right place, and this was a bit maddening.

Here’s what I did to get it to work. My domain is registered at Pair Domains, and my old site was running at Pair. This assumes you have created a GitHub account and a repo for your GitHub pages stuff, and have an address like I have jkonrath.github.io.

Disclaimer: I’m not an IT professional, and you could mess up everything by listening to me. You probably shouldn’t listen to me about anything, let alone something involving data loss. You’ve been warned.

The Pair part:

1. Log in to the Pair ACC site. Back up the old WordPress site. Don’t forget to back up the database, too.
2. Go to Domains and select the domain from the list.
3. Select Delete Domain From Account.

   I only needed to do these three things because the domain was pointed at an IP and subdirectory of another host I run there. If you only registered a domain at Pair Domains and don’t host the site there, you don’t have to do this.

4. Log in to the Pair Domains site, and select your domain name.
5. Go to Domain Address Settings. This may be disabled by default; I had to accept terms and turn it on first.
6. If you have Website Forwarding set, turn that off by deleting the forwarding URLs.

7. From the Add New Record dropdown list, select CNAME (Parking).

   1. In the left side under Alias, put www.
   2. In the right, under Points To, put yourusername.github.io.
   3. Select Add Record.
8. Go back to Add New Record, and select A (Round Robin).
9. Under Host Name, put @ and under IP Addresses, put these four IP numbers:

    185.199.108.153
    185.199.109.153
    185.199.110.153
    185.199.111.153
   

10. Select Add Record. You will now have a CNAME for www pointing to your GitHub Pages domain, and four A records pointing to the IP addresses above.
    
    

Note: Double-check this nine times. The CNAME is www >> yourusername.github.io and there are four A records that are @ >> 185.199.x.y If you get the www and @ backwards, this won’t work.

After you do this, you have to wait. It could be a minute; it could be a day. A good way to test it is whatsmydns.net, which shows how your changes have propagated around the world.

Once that sorts itself out:

1. Go to GitHub, and open the repo for your blog.
2. Select Settings, then Pages. It will say your page is being hosted at yourusername.github.io. If it isn’t, you’ve got bigger problems. Sort those out first.
3. Under Custom Domain, enter the custom domain and select Save. You’re putting in www.my-host-name.com. There’s no protocol in front of it (http://) but don’t forget the www.
4. This will churn away and check the DNS for you. It will also kick off a request to Let’s Encrypt to make a certificate for free. You do not have to pay for anything at Pair or do any other legwork to get this done. The catch is that if you messed up the first part, or if GitHub’s feeling grumpy, that creation step will get botched, and you won’t get any helpful information, except it won’t work.
5. Leave it alone for an hour or a day, and then you can select Enforce HTTPS and it will (eventually) enable HTTPS.

On the last step: it may give you a byzantine error message, like “Unavailable for your site because a certificate has not yet been issued for your domain.” If that happens:

1. Make sure your CNAME and A records on Pair Domains are correct.
2. Wait a bit.
3. Under Custom Domain in the GitHub Pages config, select Remove, then add it again. This will redo the request for a new certificate. Or not. I think I did it five times before it took.

You may need to clear your browser cache or wait a bit more until this works, but test it with and without HTTPS and www.

Interview question - calculating a factorial

When I was a tech writer, almost every time a developer interviewed me, they would inevitably ask me to whiteboard how to calculate the factorial of a number. When I moved to Northern California in 2008 and started interviewing at various Bay Area tech firms, I was seriously asked to do this exact problem at least twelve times in interviews with three companies.

I thought of this recently after reading this, and thinking of the smart-aleck answers I never did give during interviews, like writing it in PostScript or COBOL.

(BTW, a factorial is the product of all positive integers between 1 and n. It’s denoted as n! So 4! = 1 * 2 * 3 * 4 = 24.)

Iteratively

The simple/obvious answer is doing it iteratively. In C:

int factorial(int n)
{
  int i;
  int result=1;
  for (i=1; i<=n; i++){
    result = result * i;
  }
  return result;
}

Extra credit:

• That should fail if you called it with a zero or a negative number.
• There isn’t a main() that asks for a number and prints the result in a pretty way.
• If you want to be cute, use the assignment operator result *= i instead of result = result * i and save nine keystrokes.
  
  

Recursively

They won’t always expect this from a writer who doesn’t regularly code, but here’s the other way to do it:

int factorial(int n)
{
  if (n == 0)
    return 1;
  return n * factorial(n - 1);
}

You can make this way more incomprehensible with the ternary operator:

int factorial(int n)
{
  return(n==1||n==0) ? 1 : n*(factorial(n-1));
}

…Other

Scheme

I went to Indiana University at a time when the first three or four computer science classes were all taught in Scheme. I always wanted to whiteboard this as an answer:

(define (factorial n)
  (cond ((equal? n 0) 1)
  (else (* n (factorial (- n 1))))))

Extra credit: do it with tail recursion.

Liquid

This blog is in Jekyll, so maybe you’ve worked with Liquid templates before:

{% assign n = 20 %}
{% assign result = 1 %}
{% for i in (1..n) %}
{% assign result = result | times i %}
{% endfor %}
{{ result }}

(Tip: if you have to put a Liquid template in a code block in Jekyll, look at the source of this page in GitHub. I’d explain, but delimiting the text in another example isn’t working.)

REST API

APIs are the future (not speaking for my employer, of course) so maybe you want to use a REST API to do it:

curl http://api.mathjs.org/v4/?expr=5!

(Why use cURL though? There’s a much better way.)

Standard libraries

If they forget to qualify their question with “don’t use standard libraries” you can do this (Python):

import math

def factorial(x):
  print (math.factorial(x))

Commodore BASIC 2.0

Let’s take it back to the beginning:

SQL

I was trying to figure this out, but my SQL days are long behind me. You could use a recursive common table expression to create a table of n rows with each row containing the result of the previous row multiplied by the row number… or something.

PDF

This is the point in my research where I had to give up and walk away for a bit. But if you had the right PDF CLI library, you could write a shell script that creates a one-page blank PDF, then iteratively merges copies of that template PDF onto a result PDF and count the number of pages at completion. There’s some magic number limit of objects in the PDF specification so they still work on 32-bit machines – eight million or so – which means this would break just past the factorial of 10.

Actually, a lot of these would break after about 12, when you’d hit INT_MAX. There’s a way to do bigger numbers by creating an array of the number of digits you want to calculate, then writing a multiply function that does all of the carrying when each spot in the array goes past 9, etc. If you really want to push it, use a linked list instead of an array so you won’t waste any space. This probably won’t fit on one whiteboard.

PostScript

Oh, here it is in PostScript (I don’t know PostScript anymore; I borrowed it from here…)

/factorial { 1 dict begin
  /n exch def
  n 0 eq {
    1
  }{
    n n 1 sub factorial mul
  } ifelse
end } def

(The serious answer to all of this, if you’re a developer tasked with interviewing a tech writer, is to ask them about their problem-solving methodology, and how they figure things out when they don’t know the answer. People who have to write a code sample every other month won’t know off the top of their head how to reverse a linked list. They should be able to talk you through a difficult problem they had to solve once, though. It’s probably a cross-functional review, right? Test their soft skills, not their ability to memorize. Just my opinion.)