Aller au contenu

A single repository?

Ce contenu n’est pas encore disponible dans votre langue.

Ideally, all content should be placed in a single repository, such as Git version control software. This maximizes reuse, consistency, and quality. If the content is in DITA XML or DocBook format, for example, the single-sourcing capabilities of these formats can be fully exploited to publish the content in the appropriate form.

Content becomes a network of information modules, and the relationships within this network need to be managed, particularly during updates.

Single documentation repository centralizing all DITA XML and DocBook content for maximum reuse and consistency Single Repository

In practice, it appears that very few companies have taken this step. It is true that until structured formats are taught earlier in education, it seems unrealistic to expect all team members within a company to adopt them, especially if employee turnover is high. A CMS can help bridge the gap, but its reliability must be carefully evaluated.

Additional resources