Keep the example template near the top of docs.

kaj · kaj · commit 32e82c442422 · 2025-02-03T19:03:07.000+01:00
diff --git a/src/lib.rs b/src/lib.rs
@@ -12,6 +12,33 @@
 //!    Templates (and static assets) are included in the compiled
 //!    program, which can be a single binary.
 //!
+//! The template syntax, which is inspired by [Twirl], the Scala-based
+//! template engine in [Play framework], is documented in
+//! the [Template_syntax] module.
+//! A sample template may look like this:
+//!
+//! ```html
+//! @use any::rust::Type;
+//!
+//! @(name: &str, items: &[Type])
+//!
+//! <html>
+//!   <head><title>@name</title></head>
+//!   <body>
+//!     @if items.is_empty() {
+//!       <p>There are no items.</p>
+//!     } else {
+//!       <p>There are @items.len() items.</p>
+//!       <ul>
+//!       @for item in items {
+//!         <li>@item</li>
+//!       }
+//!       </ul>
+//!     }
+//!   <body>
+//! </html>
+//! ```
+//!
 //! # Getting started
 //!
 //! The aim of ructe is to have your templates and static files accessible to
@@ -64,35 +91,6 @@
 //! assert_eq!(buf, b"<h1>Hello World!</h1>\n");
 //! ```
 //!
-//! # Template syntax
-//!
-//! The template syntax, which is inspired by [Twirl], the Scala-based
-//! template engine in [Play framework], is documented in
-//! the [Template_syntax] module.
-//! A sample template may look like this:
-//!
-//! ```html
-//! @use any::rust::Type;
-//!
-//! @(name: &str, items: &[Type])
-//!
-//! <html>
-//!   <head><title>@name</title></head>
-//!   <body>
-//!     @if items.is_empty() {
-//!       <p>There are no items.</p>
-//!     } else {
-//!       <p>There are @items.len() items.</p>
-//!       <ul>
-//!       @for item in items {
-//!         <li>@item</li>
-//!       }
-//!       </ul>
-//!     }
-//!   <body>
-//! </html>
-//! ```
-//!
 //! There are some [examples in the repository].
 //! There is also a separate example of
 //! [using ructe with warp and diesel].
