Katrina Moody Profile picture
Jan 4 โ€ข 17 tweets โ€ข 4 min read
Looking for a new job and I had this problem.

I work under NDAs and don't have a lot of my actual work as a technical writer I can point to and say - "This is mine."

I asked around and realized it was a common issue.

But most 'sample' portfolio ideas made me cringe.

A ๐Ÿงต๐Ÿ‘‡
Suggestions I found online were to write a how-to article as a technical writer.

Their ideas:

ยท How to make a PB sandwich ๐Ÿฅช
ยท How to fold a paper airplane ๐Ÿ“ƒ
ยท How to tie a tie ๐Ÿ‘”
ยท How to post on FB โ‰๏ธ

I didn't want to write any of those.

Also, they were stupid.
So I dug a little deeper and found some better ideas for sample papers and articles I could write. I was thinking about it ...

Then I had a bright idea. ๐Ÿ’ก

What if I turned something I know how to do into a true project?

Something that I could get excited about?
I posted yesterday about what I settled on because I was way too excited about it. (Don't judge me! I'm a nerd, we like nerdy things ๐Ÿ˜›)

I decided to put together a technical style guide.

One that could be used for internal teams and internal documentation needs.
Folks! Seriously.

I went from thinking I'd put together a quick MVP guide, maybe 2,000 words. I'd prove I could do the thing.

Then the devil on my shoulder said, 'but what now?'

So I went a little overboard...
First I used Obsidian (@obsdmd rocks!) for collecting all my notes together and writing the thing.

Then, I started thinking about how I'd present the thing and said to myself, "Hey, why not put it up on your site?"

So I have a "portfolio" on my site, and ...
Oh, my site is a #WordPress site (bc it rocks and I love it) even though I write on Medium sometiimes.

My portfolio is just a page with a few special blocks and little bit of positioning CSS (bc I'm picky).

Then, I linked to the Style Guide and ...
I build a mini set of blocks just to use for my Style Guide pages (for now I didn't create CPT or anything, but I might eventually).

And so I'm still in the process of adding it to my site.
Then, I was like, maybe this can help other folks?

So I went back through what I had written of my guide, and realized it wouldn't be that hard to help people customize it (say for smaller businesses or agencies).

So I created a questionnaire and ...
I went through the guide, expanded it, then started adding a few comments/notes in brackets throughout so it was even easier to customize.

So now, today I'll finish up some of the sections I added, and get it all put up on the site.

But what about...
Once it's completed, I'll also set it up in Word and have that file available to download from the project how-to page on my site. ๐Ÿ˜€

(Hey, look at that! I DID get to write a how-to article of sorts!)

BUT ...
The more exciting ideas came up this morning in one of my writing groups.

Another technical writer suggested I set it up as an ebook and workbook. ๐Ÿ˜ณ

I just don't think my nerdy heart can take all the excitement.

Because I was already thinking ...
Maybe I could also put the guide itself up on GitHub so anyone can use it as a starting point.

Or GitBook (or both!) ... on Notion. (eventually) Use Obsidian publish.

The sky's the limit.

All because I didn't like the answer I got to a pretty common question. ๐Ÿ˜
PS - I *know* there are great options available on style guides in general.

But there are differences between one used for internal documentation/teams and one used for marketing and/or branding purposes.

And every company is different and uses different tools, etc.
PSS - Also, ChatGPT folks will understand just how much fun it was having a "conversation" with my AI friend about the best things to include in each section, and even whether my outline made sense.

I compared my outline to the one spun up by ChatGPT for each section.
I've mentioned before I'm not that impressed with ChatGPT's actual writing ability. So I don't really use it for that, because if I did it would be a word salad, repetitively boring kind of thing ๐Ÿคฃ
@threadreaderapp unroll

(new shiny tool - is this all I have to do?)

โ€ข โ€ข โ€ข

Missing some Tweet in this thread? You can try to force a refresh
ใ€€

Keep Current with Katrina Moody

Katrina Moody Profile picture

Stay in touch and get notified when new unrolls are available from this author!

Read all threads

This Thread may be Removed Anytime!

PDF

Twitter may remove this content at anytime! Save it as PDF for later use!

Try unrolling a thread yourself!

how to unroll video
  1. Follow @ThreadReaderApp to mention us!

  2. From a Twitter thread mention us with a keyword "unroll"
@threadreaderapp unroll

Practice here first or read more on our help page!

Did Thread Reader help you today?

Support us! We are indie developers!


This site is made by just two indie developers on a laptop doing marketing, support and development! Read more about the story.

Become a Premium Member ($3/month or $30/year) and get exclusive features!

Become Premium

Don't want to be a Premium member but still want to support us?

Make a small donation by buying us coffee ($5) or help with server cost ($10)

Donate via Paypal

Or Donate anonymously using crypto!

Ethereum

0xfe58350B80634f60Fa6Dc149a72b4DFbc17D341E copy

Bitcoin

3ATGMxNzCUFzxpMCHL5sWSt4DVtS8UqXpi copy

Thank you for your support!

Follow Us on Twitter!

:(