Update some last docs, bnf grammars

1 files changed, 9 insertions, 5 deletions

diff --git a/src/construct/label_start_image.rs b/src/construct/label_start_image.rs
index ffc1aee..8d35df2 100644
--- a/src/construct/label_start_image.rs
+++ b/src/construct/label_start_image.rs
@@ -1,16 +1,20 @@
-//! Label start (image) is a construct that occurs in the [text][] content
-//! type.
+//! Label start (image) occurs in the [text][] content type.
 //!
-//! It forms with the following BNF:
+//! ## Grammar
+//!
+//! Label start (image) forms with the following BNF
+//! (<small>see [construct][crate::construct] for character groups</small>):
 //!
 //! ```bnf
 //! label_start_image ::= '!' '['
 //! ```
 //!
+//! ## HTML
+//!
 //! Label start (image) does not, on its own, relate to anything in HTML.
 //! When matched with a [label end][label_end], they together relate to the
 //! `<img>` element in HTML.
-//! See [*§ 4.8.3 The `img` element*][html-img] in the HTML spec for more info.
+//! See [*§ 4.8.3 The `img` element*][html_img] in the HTML spec for more info.
 //! Without an end, the characters (`![`) are output.
 //!
 //! ## Tokens
@@ -26,7 +30,7 @@
 //!
 //! [text]: crate::construct::text
 //! [label_end]: crate::construct::label_end
-//! [html-img]: https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element
+//! [html_img]: https://html.spec.whatwg.org/multipage/embedded-content.html#the-img-element
 
 use crate::event::Name;
 use crate::resolve::Name as ResolveName;