stake-contract: Add docs comments

dusk-network · Dec 30, 2024 · c218dd7 · c218dd7
1 parent 8e6bb49
commit c218dd7
Show file tree

Hide file tree

Showing 2 changed files with 214 additions and 22 deletions.
diff --git a/contracts/stake/src/lib.rs b/contracts/stake/src/lib.rs
@@ -4,9 +4,21 @@
 //
 // Copyright (c) DUSK NETWORK. All rights reserved.
 
+//! # Stake Contract Documentation
+//!
+//! This contract manages staking-related state for the Dusk Network,
+//! implementing core functions that facilitate the management of stakes,
+//! rewards and penalties.
+//!
+//! Refer to the [Dusk Whitepaper](https://dusk-cms.ams3.digitaloceanspaces.com/Dusk_Whitepaper_2024_4db72f92a1.pdf) and
+//! [Dusk Documentation](https://docs.dusk.network) for a detailed explanation of staking mechanisms.
+
 #![cfg_attr(target_family = "wasm", no_std)]
 #![cfg(target_family = "wasm")]
 #![feature(arbitrary_self_types)]
+#![deny(missing_docs)]
+#![deny(rustdoc::broken_intra_doc_links)]
+#![deny(clippy::pedantic)]
 #![deny(unused_crate_dependencies)]
 #![deny(unused_extern_crates)]