From d36a2a8e95ee8dfbceada7a4e7ff9a06ba9f3a9b Mon Sep 17 00:00:00 2001
From: Tristan Guichaoua <tguichaoua.dev@gmail.com>
Date: Thu, 17 Aug 2023 11:54:22 +0200
Subject: [PATCH 1/2] doc(bevy_input): modules docs

---
 crates/bevy_input/src/axis.rs     | 2 ++
 crates/bevy_input/src/gamepad.rs  | 2 ++
 crates/bevy_input/src/input.rs    | 2 ++
 crates/bevy_input/src/keyboard.rs | 2 ++
 crates/bevy_input/src/lib.rs      | 7 +++++++
 crates/bevy_input/src/mouse.rs    | 2 ++
 crates/bevy_input/src/touch.rs    | 2 ++
 crates/bevy_input/src/touchpad.rs | 2 ++
 8 files changed, 21 insertions(+)

diff --git a/crates/bevy_input/src/axis.rs b/crates/bevy_input/src/axis.rs
index 895c35e04b44b..5fc3b787ae061 100644
--- a/crates/bevy_input/src/axis.rs
+++ b/crates/bevy_input/src/axis.rs
@@ -1,3 +1,5 @@
+//! The generic axis type.
+
 use bevy_ecs::system::Resource;
 use bevy_utils::HashMap;
 use std::hash::Hash;
diff --git a/crates/bevy_input/src/gamepad.rs b/crates/bevy_input/src/gamepad.rs
index 6948d7e6286a3..5eb29ddf2e1c7 100644
--- a/crates/bevy_input/src/gamepad.rs
+++ b/crates/bevy_input/src/gamepad.rs
@@ -1,3 +1,5 @@
+//! The gamepad input functionality.
+
 use crate::{Axis, Input};
 use bevy_ecs::event::{Event, EventReader, EventWriter};
 use bevy_ecs::{
diff --git a/crates/bevy_input/src/input.rs b/crates/bevy_input/src/input.rs
index 3758840fecd65..803b740799f9a 100644
--- a/crates/bevy_input/src/input.rs
+++ b/crates/bevy_input/src/input.rs
@@ -1,3 +1,5 @@
+//! The generic input type.
+
 use bevy_ecs::system::Resource;
 use bevy_reflect::{std_traits::ReflectDefault, Reflect};
 use bevy_utils::HashSet;
diff --git a/crates/bevy_input/src/keyboard.rs b/crates/bevy_input/src/keyboard.rs
index edf291b6320d9..1c5648c7687ac 100644
--- a/crates/bevy_input/src/keyboard.rs
+++ b/crates/bevy_input/src/keyboard.rs
@@ -1,3 +1,5 @@
+//! The keyboard input functionality.
+
 use crate::{ButtonState, Input};
 use bevy_ecs::entity::Entity;
 use bevy_ecs::{
diff --git a/crates/bevy_input/src/lib.rs b/crates/bevy_input/src/lib.rs
index ab5b445bf5529..d0fd957cf00ed 100644
--- a/crates/bevy_input/src/lib.rs
+++ b/crates/bevy_input/src/lib.rs
@@ -1,5 +1,11 @@
 #![allow(clippy::type_complexity)]
 
+//! Input functionality for the [Bevy game engine](https://bevyengine.org/).
+//!
+//! # Supported input devices
+//!
+//! `bevy` currently supports keyboard, mouse, gamepad, and touch inputs.
+
 mod axis;
 /// Common run conditions
 pub mod common_conditions;
@@ -13,6 +19,7 @@ pub mod touchpad;
 pub use axis::*;
 pub use input::*;
 
+/// Most commonly used re-exported types.
 pub mod prelude {
     #[doc(hidden)]
     pub use crate::{
diff --git a/crates/bevy_input/src/mouse.rs b/crates/bevy_input/src/mouse.rs
index deb8b8c4a03a1..062a1ed7647aa 100644
--- a/crates/bevy_input/src/mouse.rs
+++ b/crates/bevy_input/src/mouse.rs
@@ -1,3 +1,5 @@
+//! The mouse input functionality.
+
 use crate::{ButtonState, Input};
 use bevy_ecs::entity::Entity;
 use bevy_ecs::{
diff --git a/crates/bevy_input/src/touch.rs b/crates/bevy_input/src/touch.rs
index 64293b9d22426..f3660233e66b5 100644
--- a/crates/bevy_input/src/touch.rs
+++ b/crates/bevy_input/src/touch.rs
@@ -1,3 +1,5 @@
+//! The touch input functionality.
+
 use bevy_ecs::event::{Event, EventReader};
 use bevy_ecs::system::{ResMut, Resource};
 use bevy_math::Vec2;
diff --git a/crates/bevy_input/src/touchpad.rs b/crates/bevy_input/src/touchpad.rs
index 358c44585edbd..46105c9b866d3 100644
--- a/crates/bevy_input/src/touchpad.rs
+++ b/crates/bevy_input/src/touchpad.rs
@@ -1,3 +1,5 @@
+//! The touchpad input functionality.
+
 use bevy_ecs::event::Event;
 use bevy_reflect::Reflect;
 

From 1e853cf600e7281b662ede0bae1415105ba60fd5 Mon Sep 17 00:00:00 2001
From: Tristan Guichaoua <tguichaoua.dev@gmail.com>
Date: Sat, 19 Aug 2023 19:31:49 +0200
Subject: [PATCH 2/2] add `warn(missing_docs)`

---
 crates/bevy_input/src/lib.rs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/crates/bevy_input/src/lib.rs b/crates/bevy_input/src/lib.rs
index d0fd957cf00ed..372cc17e11bff 100644
--- a/crates/bevy_input/src/lib.rs
+++ b/crates/bevy_input/src/lib.rs
@@ -1,4 +1,5 @@
 #![allow(clippy::type_complexity)]
+#![warn(missing_docs)]
 
 //! Input functionality for the [Bevy game engine](https://bevyengine.org/).
 //!