Home » Archives for Vaibhav Gupta

Vaibhav Gupta

Vaibhav Gupta is a certified Madcap Advanced Developer. He has more than seven years of experience as a Technical Writer. In his career, he has published documents for multiple domains in various formats and provided Technical Writing Tools training to numerous writers. He believes in the words of Ralph Waldo Emerson, "Unless you try to do something beyond what you have already mastered, you will never grow.".

Content reuse

How to maximize your content by content reuse

As a technical writer, you know it takes a good amount of time to create useful content. From analyzing the audience, researching, interviewing SMEs, product demonstrations, creating content, multiple rounds of review, and editing the content, all of these need a lot of effort. To make sure that you’re maximizing your hard work, content reuse is that practice of incorporating the same (or similar) pieces of content in many ways and different types of documents, websites, training guides, and more (for example, output types). The idea is that authors or writers need to write the content once and use the… Read More »How to maximize your content by content reuse

Design and generate output in madcap flare application

Step 3: Generate the output using the madcap flare software

Step 1: Understanding the madcap flare application Step 2: Authoring in the madcap flare software Step 3: Generate the output using the madcap flare software In this post we will concentrate on adding some more styles to your project and generating an output using madcap flare application. The madcap flare application provides the following types of output: HTML5 PDF Word Clean XHTML Eclipse Help EPUB HTML If you have followed Step 1 and Step 2 of our madcap flare tutorial series, then you should have a created a project and added contents to it. However, until now we are working with individual topics. All we… Read More »Step 3: Generate the output using the madcap flare software

How technical writing is different from other forms of writing

Isn’t Technical Writing is the same as other forms of writing? There are so many different types of writing. At a bird’s eye view, all kinds of writing look similar. They all require similar skills and have one basic goal; effectively communicate the required information to the intended audience. Trust me, it is hard to make it simple. Different kinds of writing All forms of writing can be grouped into two major blocks: Creative writing: This form of writing is about authoring books, novels, poetry, TV show scripts, movie scripts, and stories. This requires great imagination, creativity, and innovation, as… Read More »How technical writing is different from other forms of writing

Authoring in Flare

Step 2: Authoring in the madcap flare software

Step 1: Understanding the madcap flare application Step 2: Authoring in the madcap flare software Step 3: Generate the output using the madcap flare software After getting familiar with the madcap flare software, it’s time to do some actual writing. In this post, I will walk you through all aspects of authoring in flare. Just to remind you, madcap flare is a topic based authoring tool. We will be editing topics throughout this post. If you want to know how to create, open, and edit a topic, then read our first post of this madcap flare tutorial series on Understanding… Read More »Step 2: Authoring in the madcap flare software

What is a Style guide and Why do you need it?

What is a style guide and why is it important

A style guide ensures that your published content is consistent, polished, recognizable, and more enjoyable. When designing a style guide, you should always put your readers or audience first. An accurate and well-written style guide helps you create a recognizable, winning voice and personality with which readers can form a more personal connection. What is a style guide A style guide or manual of style is a collection of rules for the writing, formatting, and layout of documents. One can use these rules for general purposes, or specific to the organization or document type. Sometimes, these rules are called Stylesheet;… Read More »What is a style guide and why is it important

madcap flare interface

Step 1: Understanding the madcap flare application

Step 1: Understanding the madcap flare application Step 2: Authoring in the madcap flare software Step 3: Generate the output using the madcap flare software This is the first step in our madcap flare tutorials for beginners series, how to use madcap flare application. As a new user, it is always best to understand the software, before working with it. It is good to familiarize yourself with: Its interface Know what different options are available How to access them. When I started working with Flare, I was confused with the term project. I was creating an online help file and… Read More »Step 1: Understanding the madcap flare application

What is technical writing in the modern world

Do you know that according to an article published in The Economic Times, there is almost a 20% year-on-year growth in the number of opportunities in the field of technical communication? According to Glassdoor, the average salary of a technical writer in the United States is $ 57,282/yr, while in India it is ₹624K/yr. In this post, I will walk you through the life of a technical writer, day to day activities, skills, and how the technical writing field is evolving with the advancement of technology. Definition In the words of the Society for Technical Communication, technical communication is a… Read More »What is technical writing in the modern world

Madcap flare tutorial for beginners – How to use madcap Flare in 3 simple steps

Step 1: Understanding the madcap flare application Step 2: Authoring in the madcap flare software Step 3: Generate the output using the madcap flare software This is a series of madcap flare tutorial for beginners which is aimed to explain How to use madcap Flare in 3 simple steps. Are you overwhelmed by looking at Madcap flare features? Do you want to learn madcap flare but not sure where to start? When I started technical writing with madcap Flare in 2016, I was excited after looking at its features. I wanted to use all the features and create an online… Read More »Madcap flare tutorial for beginners – How to use madcap Flare in 3 simple steps

How to create version filters in madcap FLARE

Version filters or filter drop-down list, is used to dynamically change the content as per the users’s selection. Do you have online help that serves multiple types of audiences? Do you want to give your user the freedom to choose the version of the help?If you have these questions in your mind and thinking how to achieve it in madcap FLARE then, this post is for you. In this post, I will provide you a step-by-step guide to create a dropdown filter in madcap FLARE.I am using Condition tags, a little bit of Javascript, and Windows session storage property of… Read More »How to create version filters in madcap FLARE

A complete list of technical writing tools

Every job profile is known for their skills and tools. If I ask you to imagine a plumber, the first picture that would come into your mind, must be of a person holding a wrench. When I think of a technical writer, the picture of technical writing tools that comes into my mind is of a person holding a pen.Yes, a pen does the basic job of writing, but in the modern world, it is not enough.In the modern world, technical writers need to create instructions that are rich in graphics and easily accessible on different devices.As a technical writer,… Read More »A complete list of technical writing tools