Purpose: This paper aims to address the issue of matching controlled vocabulary on agroforestry from knowledge organization systems (KOS) and incorporating these terms in DITA markup. The paper has been selected for an extended version from MTSR'11. Design/methodology/approach: After a general description of the steps taken to harmonize controlled vocabulary on agroforestry, a general discussion of related work enriching documents and matching controlled vocabularies as well as details on managing controlled vocabulary in DITA are provided. Findings: The paper identifies a number of practical and theoretical issues in matching controlled vocabulary from different sources, e.g. the complexity of addressing inconsistencies and incompatibilities between systems, and came across a number of approaches to semantically enrich documents, such as semantic-document approach, facet classification, and integrating metadata and markup in documents. Practical implications: Ways of incorporating controlled vocabularies into DITA markup are presented that can be drawn upon to guide future work in this area. Originality/value: No previous work has reflected on the actual experience used to enrich DITA markup, especially with reference to the agroforestry domain. (Contains 8 figures and 1 table.)