The currently used style of suite files relies heavily on a set of variables (scope Test or higher) of predefined names and semantics. Some are initialized in suite's Variables table, some are silently set by some keywords and used by other keywords.
As such variables have fixed names, we can de-duplicate the documentation into a standalone document (or set of documents), similarly to how we document test tags.
This way we can write a longer description with all the fine points only once, and keep only a minimal documentation in keywords.