The DISS Diagnostic Trees are XML files that define a particular issue scope and various diagnostic information pertaining to that scope. Diagnostic Trees not only define commands like sound tests, and how to gather information, but also how to format that information in the report. Furthermore diagnostic trees are able to link to one another and inherit formatting and diagnostic commands from one another.
Scopes
Core Diagnostics Tree
The core diagnostics tree should gather information pertaining to all issues such as:
- User language
- Debian branch/version (including verification that this IS actually Debian)
- Kernel Version
- Apt information (sources, policy, prefers.. etc)
- etc..
Type of issue
Diagnostic trees that broadly apply to the type of issue such as:
- Input (Keyboard/Mouse/Joystick/Touchscreen etc.)
- Network
- Sound
- Video
- etc.
Package
Diagnostic trees specific to individual packages that identify where their config files are kept, how the maintainer wants reports formatted, what information the maintainer wants in those reports, and what commands the maintainer would like you to run, or things the maintainer would like you to try before filing a report.