diff --git a/src/lib.rs b/src/lib.rs
index b02f407..1e8da79 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,12 +1,11 @@
 // SPDX-FileCopyrightText: Copyright 2023-2025 Arm Limited and/or its affiliates <open-source-office@arm.com>
 // SPDX-License-Identifier: MIT OR Apache-2.0
 
-//! # Peripheral Access Crate fro Arm Fixed Virtual Platform
-//!
-//! The crate provides access to the peripherals of [Arm Fixed Virtual Platform](https://developer.arm.com/Tools%20and%20Software/Fixed%20Virtual%20Platforms).
-
 #![no_std]
+#![doc = include_str!("../README.md")]
+#![deny(clippy::undocumented_unsafe_blocks)]
 
+pub mod power_controller;
 pub mod system;
 
 // Re-export peripheral drivers and common safe-mmio types
@@ -14,7 +13,6 @@
 pub use arm_pl011_uart;
 pub use arm_sp805;
 pub use safe_mmio::{PhysicalInstance, UniqueMmioPointer};
-pub mod power_controller;
 
 use arm_gic::GICDRegisters;
 use arm_pl011_uart::PL011Registers;
@@ -114,8 +112,8 @@
     pub uart2: PhysicalInstance<PL011Registers>,
     pub uart3: PhysicalInstance<PL011Registers>,
     pub watchdog: PhysicalInstance<SP805Registers>,
-    pub gicd: PhysicalInstance<GICDRegisters>,
     pub power_controller: PhysicalInstance<FvpPowerControllerRegisters>,
+    pub gicd: PhysicalInstance<GICDRegisters>,
 }
 
 impl Peripherals {