Let’s talk about how to make good OA content.
I have been writing open build threads since 2014 and sharing open content before that. I’ve developed my own style over the years and have opinions about what works and what does not work for OA/build thread content. I think it would be useful to share some of my thoughts as the OA sees explosive growth.
OA posting is technical writing. Sure, the environment is much less formal than academia, but the same basic rules of technical writing apply.
-
You suck at technical writing. Paraphrased from my Dad and Mom. Technical writing is hard, basically untaught before college, and from evidence available to me it is often poorly taught in college. You will have to work hard to be good at it.
-
Be concise. Paragraphs should be four sentences or shorter. No run-on sentences. Long blocks of text are rarely engaging, and people will ask for more detail in the areas of their interest.
-
Don’t waste time writing about what you see. Take pictures and video (or make other visual content) and share those instead. Provide bullet notes on what you see. Your audience can, and will, notice things your whole team missed. Sometimes these insights are critical.
-
Acknowledge that you have your own biases, even if it’s just to yourself. We are all biased. “I like using virtual 4-bars” or “colson wheels have served us well in the past” are the type of phrases I like to use and see in OA posts to acknowledge these biases.
-
Share failures, but be positive and not whiny. E.g. a 2018 video where our elevator assembly experienced rapid unplanned disassembly during testing was quite popular. Seeing a team explode things during testing, do a failure analysis, and implement a solution is a REALLY helpful process to share. Some of the best feedback I have received from a build thread has been about sharing our failures.
Now that I’ve made an OA post that breaks many of the rules I suggest…
- Understand the rules so you know when to break them. No, not like the game rules, that’s not okay. Breaking the rules such as ‘I try to never have posts that are all text,’ but ‘this post doesn’t really benefit from graphics, so, I’m skipping it’ kind of breaking the rules.
Good luck, and be open!