The use cases for these macros may not be obvious at first sight. Here is one example use case for each of the two macros. Transclusion Macro: A decision document may contain information about what has been decided, the reasons for the decision and a list of alternatives. Besides this there may be further sections containing detailed information, why a particular alternative has been rejected. It may also list the experts that decided and reference material they used to decide. In an overview document an author may only be interested in the decision, the reason, and the list of alternatives. The Transclusion Macro allows to do that. Transclude Documents Macro: Assume the last use case but now you want to list the information of all decision documents that are tagged with the term "software architecture". The Transclude Documents Macro will fetch each matching document and renders only the sections containing the decision, the reason, and the list of alternatives. |