Operation Cleanup: CSS refactoring for InfoDevs

Hey, fellow writers who work in MadCap Flare! Have you ever opened your CSS style sheet in a text editor and checked if it contains conflicting entries, style duplicates, or empty style definitions? Maybe there are unnecessary repetitions of a property assigned to child elements, but this property is already assigned to a parent element? (I had this problem with fonts and colors).

Being unsure of what is going on with your CSS, you might be surprised to find that, for example, after you changed one property, half of your document inexplicably changed its color or indentation level. And there you are wasting time trying to apply a quick fix that most probably breaks something else. It is only then that you finally realize that the CSS refactoring time has come. Continue reading

Link

Quick start vs. Getting started: is there a difference?

Today, we want to share a great post that raises a tricky question: what is a Quick start guide to you?

Many thanks to Sarah Maddox (ffeathers) for raising this seemingly simple but often overlooked problem of definitions and mismatching assumptions.

Continue reading

Book review: Logic made easy. How to know when language deceives you?

Logical thinking is high on the list of qualities expected from any Information Developer. But what exactly is “being logical”? If my writing is seemingly clear and makes sense to anyone who reviewed it, am I thinking logically? My layman’s definition of “logical” used to be “making sense”, but recently the book Logic made easy has come my way and added a lot to my understanding. Continue reading

Link

Color theory: the mystery unveiled

Today I want to share with you a brilliant post covering all the basics that an Information Developer should know about how colors work, brought to you by Dave Gash, a Technical Writer at Google.

In a nutshell, it’s a great read—both fun and educational—that explains how colors work. It’s all there – physics, optics, additive and subtractive color systems, hexadecimal arithmetic (!) and, most importantly, demonstration of how it all works together in real life (I mean, in a real-life CSS).

Believe it or not, CSS color codes really are intuitive. You’ll be surprised to see how obvious it is that “#000000 can’t be anything but black“, and “#ff0000 cannot possibly be anything but bright red“. On top of that, there’s a quiz, real-life CSS examples, and links to useful resources and tools, which all adds immensely to the post’s educational value.

Thanks to the author for gathering all this information and presenting it in such a fun and easy way! That’s rock’n’roll, folks.

View at Medium.com

Book review: “The First 20 Hours: How to Learn Anything… Fast”

In the ever-changing work environment, Information Developers must constantly acquire new skills to stay professionally relevant. I assume that we all have our learning strategies and strive for perfection. As the saying goes, “practice makes perfect”. But how often do we give up the mere idea of learning just because we remember the popular theory of 10.000 hours of practice that inevitably separates us form perfection?

Today I would like to share my impression of the book “The First 20 Hours: How to Learn Anything… Fast” by Josh Kaufman, one of the world’s top 100 business authors. In his book, Kaufman explains that quick acquisition of any practical skill is possible within just 20 hours – or even less. The book, first published in 2013, became a bestseller right away. Since then, the idea that quick learning is possible keeps making a significant shift in the minds of aspiring learners. Continue reading

interviewing SME

Interviewing SMEs: Prepare, Talk, and Troubleshoot

Interviewing subject matter experts (SMEs) is one of the key soft skills that an Information Developer should possess. Our job is to get the technical input and turn it into a clear and usable output: decide on what is crucial and what is irrelevant, structure the information, and illustrate it with examples or graphics. Still, the much-needed input resides in the minds of the SMEs, and we need to act wisely to retrieve it—in other words, to master the art of interviewing.

Continue reading