more examples

src/ast/spans.rs

@@ -25,13 +25,15 @@ fn union_spans<I: Iterator<Item = Span>>(iter: I) -> Span {
         .unwrap_or(Span::empty())
 }
 
-/// A trait for AST nodes that have a source span for use in diagnostics.
+/// Trait for AST nodes that have a source location information.
 ///
-/// Note: Source spans are likely not currently entirely accurate. They may
-/// 1. Be missing keywords or other tokens.
+/// # Note:
+///
+/// Source spans are not currently entirely accurate. They may
+/// 1. Be missing keywords or other tokens
 /// 2. Not have span information at all, in which case they return [`Span::empty()`].
 ///
-/// See [this ticket] for more information.
+/// See [this ticket] for more information and status.
 ///
 /// Note Some impl blocks may contain doc comments with information
 /// on which nodes are missing spans.