From icons and logos to illustrations and photos, visual content is an integral part of our internet experience. It’s out of the question that it must not only be pleasant and useful but also accessible to everyone, including visually impaired people. To achieve that, you must pair your visual content with alternative text description, or…
Continue reading »Nowadays, almost every brand has a range of accounts on different social media platforms, and we, as tech writers, can’t miss a chance to look into the matter and see for ourselves whether it could be a useful tool for us to promote documentation or not. Why Would You Need to Promote Your Documentation? Let’s…
Continue reading »Document version control is a vital part of any documentation management process, where it is necessary to keep track of all changes made to the documents. It is used in various fields, such as software development or design and construction. Document version control is required in any field of technical writing, particularly in long-term projects…
Continue reading »The way documentation looks is not just text or visuals placed on a page. The appearance of technical information includes a complex system of features. Some time ago, documentation features were regulated by style guides available in every company. Traditionally, company style guides were based on popular stylebooks such as the Modern Language Association Handbook,…
Continue reading »The creation of content is an on-going process. The company’s technical writers constantly create content to support the product, incorporating new features and developments. Additionally, it is common for similar issues to be covered in different documents, as is typical for CCMSs (component content management systems). These circumstances give rise to the challenges of searchability…
Continue reading »These days, PDF files — short for “Portable Document Format” — are one of the most regularly used files. One can say it has almost become a usual requirement that simplifies the interaction between departments and increases the working productivity overall. There are some undeniable advantages that made PDFs such a helpful office assistant. Compatibility….
Continue reading »If technical writing is your trade, you should know that it is not a one-way street. Technical writers collaborate with other stakeholders, such as managers, marketers, and developers. However, many writers tend to forget that they work primarily for the target audience. That is why the main factor in developing technical documentation is the opinion…
Continue reading »A business requirements document (BRD) is a reflection of the main idea behind a project. It describes the goals and objectives of the project and the results it is designed to achieve. No matter what field you are working in, you need a robust BRD to manage and align all the activities within the project….
Continue reading »Today, documentation is one of your company’s assets. It helps your customers understand how your product works or, putting it differently, enhances the usability of your product. This is why documentation should often combine seemingly opposite features. It should be both comprehensive and concise, visually appealing yet informative, neutral but also stylish (or even extravagant…
Continue reading »Our latest Blossom update will take your content creation to the next level with Markdown import, better PDF export, Confluence import updates, and more. We have made the initial steps towards a complete transformation of the Contributor’s app that are sure to ease your work inside the portal. Furthermore, we have implemented a bunch of…
Continue reading »