One of the many titles that we documentarians assume is user’s advocate. This means that we defend the user’s interests, cater for their information needs, and provide them with the right content at the right time. But what if some of them cannot read the help topic because the font is too small and light, or they cannot do a step in a procedure as the instructions are too vague? This means that probably, we have overlooked such thing as accessibility. Continue reading
From today’s perspective, the chatbots advancement and popularity may not be as revolutionary as expected by the enthusiasts a few years back. Anyway, the number of bots on various platforms has grown to such an extent that we can now speak of chatbots as a new way of user assistance that Information Developers should be aware of.
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.
This year I had a marvelous opportunity to attend the Evolution of TC conference in Sofia, Bulgaria. It is an annual international event for all technical communicators with a focus on innovations in software documentation. Being a place for technical writers, information developers, translators, and everyone who is interested in technical communication, it gives an excellent opportunity to exchange knowledge and ideas, learn new tendencies and trends, as well as grow network. Continue reading
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
We, bloggers, dream to make our content visible, visited, and viewed. And even if we don’t think of SEO when starting our blogs, the time to look for tools for link building and keywords research always comes.
If you have already scratched the surface of the iceberg we call SEO or you just don’t want your website to be buried in the depth of Google search results, you surely need to know the notion of latent semantic indexing (LSI). And that’s when the article by Nikolay Stoyanov may be your first and foremost resource.
Whenever in the development team it comes to building interaction between software applications, creating an app for a web solution, or integrating back end services with the front end implementation – succinct and neat API documentation is of a tremendous value for all parties involved.
Make use of the resources below to develop effective API documentation and help your engineers disperse all uncertainties around the way of using a particular API.