Usually if I make a driver a system setup file or the like in normal source code I add comments on the decisions made in there
Example 1: /* The speed of the SPi is made to match the old HammerShark device that this product will replace */
Example 2: /* The naming of the pins is chosen to match the schematic drawing no. HS_123456 */
Example 3: /* These settings is derived from the design document docserver.intraweb.net/.../123456 */
When doing all this setup in Sysconfig I am offered no easy way to store this information together with the configuration itself.
In my mind just having a single multi-line comment field for each device is plenty sufficient (device as in: the ADC, the SCI, the SPI a.s.o.)
Exporting those comments to the generated files is a nice but not needed part of this feature. This could also result in snowball effect, like do it then need to support Doxygen a.s.o.