Content reuse – a productivity booster or a vicious circle?
Single-source publishing is a powerful must-have feature that is normally among the top three competitive advantages for any professional help authoring solution – and for good reason. Single-sourcing reusable content lets you: Maintain consistency throughout your documentation in terms of style, terminology, the level of detail, and so on. Avoid making multiple updates when a user interface or a workflow changes.Reduce the review and editing effort.Reduce the localization costs.Automate the routine – reproducing the same pieces of content repeatedly adds mundane work and duplicates yo
Spell Checker for Code in IntelliJ IDEA
One day you write some code, commit, push, and then receive a comment on the pull request: “Looks good. Oh, but you misspelled this word in a class name". Now you have to change the pull request just because of the typo. Annoying and time-consuming, isn't it? How IntelliJ IDEA spellchecks code IntelliJ IDEA understands that code constructs like classes and methods should not be spellchecked like regular words. At the same time, it can split complex CamelCase names and check the spelling of each segment. If you misspell a specific word within a class name, IntelliJ IDEA will underline
Writing With Style: 10 Style Guides to Inspire You
A writing style guide is a set of rules and agreements for everyone involved in writing or editing documentation in a company. Usually, a style guide prescribes using certain words, expressions, terms, and punctuation. It can sometimes go even beyond that and cover content architecture or UI texts. What are the main benefits of following a style guide? It will be a single point of truth to keep the documentation consistent even when it's written by a team of writers, each with their own personal writing style.It alleviates the editors' workload coming from external contributors.A s
The Holy Grail of “Always-Up-to-Date” Documentation
When you ask someone what’s wrong with your documentation, the top 3 answers will be: no one reads it, it is misleading, and it is outdated. In this post, we will discuss how to keep your documentation up to date. Hey, doc! Why so outdated? Documentation is not source code. For code, you can write tests and check whether it works before the release, but for content-related things, such checks are harder to implement. So the question is this: how can we make sure documentation is up to date and working properly? But before we answer that, let’s take a step back and try to understand why i