Documents asciiquarium assets module

Adds documentation to the asciiquarium assets module,
explaining its purpose and usage.

Also fixes a formatting inconsistency in `src/lib.rs`.

Author: gitcoder89431

src/lib.rs

@@ -8,8 +8,8 @@ Agent Log:
 
 Next steps for agents:
 - Ensure `src/widgets/mod.rs` declares:
-    pub mod asciiquarium;
-    pub mod asciiquarium_assets;
+  pub mod asciiquarium;
+  pub mod asciiquarium_assets;
 */
 
 #![forbid(unsafe_code)]

src/widgets/asciiquarium_assets.rs

@@ -1,15 +1,21 @@
-use super::asciiquarium::FishArt;
+/*!
+Asciiquarium assets: a small curated set of ASCII fish plus a helper to auto-measure width and height for any multi-line ASCII art.
+
+Notes:
+- Width is the maximum visible character count across all lines (Unicode scalar count).
+- Height is the total number of lines returned by `.lines()`.
+- Leading/trailing blank lines in raw strings will count toward height.
+- Rendering code will clip as needed; assets need not avoid whitespace.
+
+These assets are intentionally simple; expand as desired with additional creatures.
 
-/// Asciiquarium assets: a small curated set of ASCII fish plus a helper
-/// to auto-measure width and height for any multi-line ASCII art.
-///
-/// Notes:
-/// - Width is the maximum visible character count across all lines (Unicode scalar count).
-/// - Height is the total number of lines returned by `.lines()`.
-/// - Leading/trailing blank lines in raw strings will count toward height.
-/// - Rendering code will clip as needed; assets need not avoid whitespace.
-///
-/// These assets are intentionally simple; expand as desired with additional creatures.
+Example:
+```text
+<º)))><
+```
+*/
+
+use super::asciiquarium::FishArt;
 
 const FISH_01: &str = r#"<º)))><"#; // Facing right
 const FISH_02: &str = r#"><(((º>"#; // Facing left