admonition-rules

Admonition hierarchy mapping defines when to use specific labels like WARNING, CAUTION, IMPORTANT, NOTE, and TIP based on potential impact severity. This standardizes warnings and notes, reducing mislabeling and miscommunication in software documentation.

Use warnings for higher potential impact situations and cautions for lower impact, guided by the MIL-STD-38784B adapted hierarchy. This ensures correct level selection and placement for clear, standardized communication in your documentation.

Validate AsciiDoc admonition placement using trigger-based compliance checks during authoring or reviewing. This validates correct level selection and placement according to MIL-STD-38784B adaptation, ensuring consistent labeling across your documentation files.

Yes, the MIL-STD-38784B adapted guidelines work directly with AsciiDoc files under the docs/ directory. The standard requires no external tooling to enforce consistent warning, caution, note, and tip labeling during authoring.

The limitation of automated style guide prompts is that triggers only activate when admonition terms appear in AsciiDoc files under docs/. The scope is restricted to labeling, placement, and level selection, excluding broader style guide or formatting compliance.