Microsoft Assistance Markup Language

Microsoft Assistance Markup Language (Microsoft AML, generally referred to as MAML) is an XML-based markup language developed by the Microsoft User Assistance Platform team to provide user assistance ("online help") for the Microsoft Windows Vista operating system. It is somewhat of a departure from all previous types of user assistance for Windows operating systems. Some of its features have been available in .NET Framework 2, but more options shipped with the release of .NET Framework 3.

The current type of user assistance for Windows operating systems uses files created with a command line compiler (hhc.exe) that compiles a .hhp (project) file, .hhc (table of contents) file, .hhk (index) file, and a collection of HTML topic files and the related resources (CSS, JavaScript, and image files) into one .chm file. The most significant aspect of MAML is that it shifts the production of user assistance to the concept of structured authoring (somewhat similar to DITA or DocBook). Documents and their constituent elements are defined by their context.

The emphasis is on content and the tasks a user performs with a computer, not the features of the software. Presentation is managed as part of the rendering engine when a user requests a topic.

The MAML authoring structure is divided into segments related to a type of content: conceptual, FAQ, glossary, procedure, reference, reusable content, task, troubleshooting, and tutorial.

Three levels of transformation occur when a topic is displayed: structure, presentation, and rendering.

The structural transformation contains reusable content and applies conditional logic to determine the structure that content should take when it is displayed, and the content of the text itself.

The presentation transformation enables content authored in MAML to use many different formats, including DHTML, XAML, RTF, and printed material.

The rendering transformation applies stylesheets and displays the final content to users.

See also

• Online help
• Microsoft Compiled HTML Help
• WinHelp
• MHTML
• Sandcastle

References

External links

• Microsoft Vista User Experience Guidelines at the MSDN Library
• Assistance Platform Team Blog at the Microsoft Developer Network (discontinued)
• MAML Guide 1.1 at Sandcastle Styles
• Help-Info: Information around Online Help (Microsoft), Examples, ..