fix(docs): make docs accurate to callout behaviour (closes #920)

docs/features/callouts.md

@@ -55,50 +55,41 @@ By default, custom callouts are handled by applying the `note` style. To make fa
 > >
 > > > [!example] You can even use multiple layers of nesting.
 
-> [!EXAMPLE] Examples
+> [!note]
->
+> Aliases: "note"
-> Aliases: example
 
-> [!note] Notes
+> [!abstract]
->
+> Aliases: "abstract", "summary", "tldr"
-> Aliases: note
 
-> [!abstract] Summaries
+> [!info]
->
+> Aliases: "info"
-> Aliases: abstract, summary, tldr
 
-> [!info] Info
+> [!todo]
->
+> Aliases: "todo"
-> Aliases: info, todo
 
-> [!tip] Hint
+> [!tip]
->
+> Aliases: "tip", "hint", "important"
-> Aliases: tip, hint, important
 
-> [!success] Success
+> [!success]
->
+> Aliases: "success", "check", "done"
-> Aliases: success, check, done
 
-> [!question] Question
+> [!question]
->
+> Aliases: "question", "help", "faq"
-> Aliases: question, help, faq
 
-> [!warning] Warning
+> [!warning]
->
+> Aliases: "warning", "attention", "caution"
-> Aliases: warning, caution, attention
 
-> [!failure] Failure
+> [!failure]
->
+> Aliases: "failure", "missing", "fail"
-> Aliases: failure, fail, missing
 
-> [!danger] Error
+> [!danger]
->
+> Aliases: "danger", "error"
-> Aliases: danger, error
 
-> [!bug] Bug
+> [!bug]
->
+> Aliases: "bug"
-> Aliases: bug
 
-> [!quote] Quote
+> [!example]
->
+> Aliases: "example"
-> Aliases: quote, cite
+
+> [!quote]
+> Aliases: "quote", "cite"