Minimalism & Information Mapping

-

    I believe two ideas help document design and also the product design.

  • Minimalism
  • Information Mapping

I want to emphasize the importance of minimalism. Most commercial products suffer from feature creep, with many features added more for novelty than for their use. According to a general estimate, we rarely use 80 percent of product features, making the product UI cluttered and the application bulky. The very same features intended to make the product easier to use will keep increasing its complexity. The same thing applies to the technical writing tools and also for Technical Writing. The writing is highly effective when the idea or concept is both concise and detailed enough. 

Most technical writing tools are affected by feature creep. One of the most common examples I want to site is the experience of copy-pasting content from some other source. You are required to clear the text formatting before pasting or while pasting, increasing the number of steps you are required to perform. Often, it is simpler to do this with a free or open-source text editor than a sophisticated authoring tool. The number of styles and the formatting options available will add more to the complexity of the product than to its utility.

Information Mapping in writing encourages presenting information in a less cluttered way with plenty of tables, charts, lists, and infographics that will make it easier to grasp information. Information Mapping is a practice more than a concept. You can worry less about the theory associated with Information Mapping and focus solely on making the information less cluttered and better organized. There is no single best way to do it. Constantly rethink the way we present information. A task generally has numbered steps. Consider a table for the same when it has to capture the gist of an entire process. The first column can have a step number, the second column having a step title, and the third column can have step details, along with any sub-steps and graphics if required. 

You can apply Information Mapping to the product design as well. Focus on having less cluttered and better-organized UI, which makes its features almost self-explanatory. It is required to have a good understanding of the styles, fonts, and the theme that can go together.

Cover page image - S.R. Crown Hall, designed by Ludwig Mies van der Rohe, 1956. Unmodified CC image courtesy of Peter Alfred Hess.

Related articles:

The ability to learn is the key to survival. We can learn faster by learning from each other.

Comments

Post a Comment

Popular posts from this blog

YAML front matter in Typora

-
Image
     I was looking for ways to add a cover page, header, and footer in Markdown and just figured out how we do it in Typora Markdown editor. It is easy. Set the header and footer using YAML Front Matter. The YAML front matter must be the first thing in the file and must be valid YAML, set between triple-dashed lines.  Source: https://support.typora.io/ The following is an example for setting the document title, header, and footer using YAML: --- title: Agile Technical Documentation header: A Quick Guide for Agile Technical Documentation footer: ${pageNo} --- Apart from this, you need to make a few PDF export settings. Select File > Preferences > Export > PDF and select the checkbox for Read and overwrite export settings from YAMAL front matters . Now, the document exported into PDF will have A Quick Guide for Agile Technical Documentation in its header and page number in its footer. If you need a cover page as well for the PDF export, paste the following content in the Ap
Read more

Technical Writing essentials

-
Image
     I want to share some of my learnings starting from the beginning days of my Technical Writing career. Everyone in the project must have a cursory understanding of the following, and the Technical Writer must understand it in detail: Language standards Learn the style guides. MSTP (Microsoft Manual of Style - currently called Microsoft Style Guide) is among the most widely followed style guides. You can access it online for free and even download the PDF for offline reference. See https://docs.microsoft.com/en-us/style-guide/welcome/ There are several other style guides, but it is mostly enough to refer only to Microsoft Style Guide. The following are some of the key takeaways: Avoid passive voice - sentences in passive voice are generally longer and harder to read. Use only the simple and easy words understood by the global audience with varying degrees of English knowledge. Your writing must have the same meaning for all people from different geographies and cultures. Never use a
Read more

Apply Goldilocks principle

-
Image
     There is one thing universal about successful managers. They keep increasing the performance benchmark every time. It applies to an athletic coach who wants to make his trainee globally competitive. I have worked under cruelly kind managers who are very ruthless in getting the tasks done. They push you to improve your competency and skills every day. You may have had a tough time working under this manager, and still, it is not something to be resented. Weathers the pressures work? We start looking for ways to do things better when the competitive edge is so narrow, and even a marginal improvement in something will give you an edge over your competitors. I had my dilemmas over if harsh managers are good or bad. A good manager sets difficult but attainable benchmarks and allows members to execute tasks with relative autonomy. There is no use flogging a dead horse. Spend time grooming the people who are motivated to do their best. I have spent time with people who do not have enough
Read more