The same subject can be treated from a marketing or pre-sales perspective, from a functional (user-driven) point of view, with screenshots and a manual, or from a technical point of view for engineers in charge of the implementation or maintenance of the system. Therefore, we can quickly end up with a dozen different versions of the same document, for the same software.Īnother key topic is audience. On the other hand, because each customer has specific needs, and these must of course be documented and kept up-to- date. On one hand because the product is evolving, and all customers do not have the same pace of upgrading their software. This forces us to maintain many different versions of the same documentation. One of the main problems that we have identified is that there are many variants out there for each of our products. I am responsible for quality, and the documentation has recently been integrated into my scope, with the aim of improving the user experience when searching for information and for the right document. What drove you to structured documentation?

Thus, by connecting to Sharepoint sites, our customers could find both product documentation and specific project documentation – each implementation involves a significant amount of personalization related to the customer’s activity, locally applicable regulations, or interfaces with their own systems. Until recently, we would mainly produce Word documents, transformed into PDF and distributed via Sharepoint. Finally, the decision makers at our customers’, for whom HPS Pre-Sales and Marketing teams manage separately PowerPoint documents. Then, developers: hundreds of files describing the design of the software, the data model.

First, the users of our 14 solutions: installation and configuration guides, technical notes, user manuals, interface and functional descriptions. In the past, the documentation team consisted of 3 people, managing a documentation corpus of several hundred documents. Historically, how was the production of documentation organized?

Hps powercard