Use AppResult alias in docs

Author: RAprogramm

src/convert.rs

@@ -46,9 +46,9 @@
 //! ```rust
 //! use std::io::{self, ErrorKind};
 //!
-//! use masterror::{AppError, AppErrorKind};
+//! use masterror::{AppError, AppErrorKind, AppResult};
 //!
-//! fn open() -> Result<(), AppError> {
+//! fn open() -> AppResult<()> {
 //!     let _ = io::Error::new(ErrorKind::Other, "boom");
 //!     Err(io::Error::from(ErrorKind::Other).into())
 //! }
@@ -61,9 +61,9 @@
 //! feature):
 //!
 //! ```rust
-//! use masterror::{AppError, AppErrorKind};
+//! use masterror::{AppError, AppErrorKind, AppResult};
 //!
-//! fn validate(x: i32) -> Result<(), AppError> {
+//! fn validate(x: i32) -> AppResult<()> {
 //!     if x < 0 {
 //!         return Err(String::from("must be non-negative").into());
 //!     }
@@ -149,9 +149,9 @@ impl From<IoError> for AppError {
 /// Prefer structured validation for complex DTOs, but this covers simple cases.
 ///
 /// ```rust
-/// use masterror::{AppError, AppErrorKind};
+/// use masterror::{AppError, AppErrorKind, AppResult};
 ///
-/// fn check(name: &str) -> Result<(), AppError> {
+/// fn check(name: &str) -> AppResult<()> {
 ///     if name.is_empty() {
 ///         return Err(String::from("name must not be empty").into());
 ///     }

src/convert/actix.rs

@@ -5,7 +5,7 @@
 //!
 //! ## What it does
 //! - Implements `actix_web::ResponseError` for [`AppError`].
-//!   - This lets you `return Result<_, AppError>` from Actix handlers.
+//!   - This lets you `return AppResult<_>` from Actix handlers.
 //!   - On error, Actix automatically builds an `HttpResponse` with the right
 //!     status code and JSON body (when the `serde_json` feature is enabled).
 //! - Provides stable mapping from [`AppErrorKind`] to

src/convert/validator.rs

@@ -19,7 +19,7 @@
 //! ## Example
 //!
 //! ```rust,ignore
-//! use masterror::{AppError, AppErrorKind};
+//! use masterror::{AppError, AppErrorKind, AppResult};
 //! use validator::{Validate, ValidationError};
 //!
 //! #[derive(Validate)]
@@ -28,7 +28,7 @@
 //!     name: String,
 //! }
 //!
-//! fn validate_payload(p: Payload) -> Result<(), AppError> {
+//! fn validate_payload(p: Payload) -> AppResult<()> {
 //!     p.validate()?;
 //!     Ok(())
 //! }

src/lib.rs

@@ -10,7 +10,7 @@
 //! - [`AppError`] — thin wrapper around a semantic error kind and optional
 //!   message
 //! - [`AppErrorKind`] — stable internal taxonomy of application errors
-//! - [`AppResult`] — convenience alias `Result<T, AppError>`
+//! - [`AppResult`] — convenience alias for returning [`AppError`]
 //! - [`ErrorResponse`] — stable wire-level JSON payload for HTTP APIs
 //! - [`AppCode`] — public, machine-readable error code for clients
 //!

src/prelude.rs

@@ -35,7 +35,7 @@ pub use crate::AppCode;
 pub use crate::AppError;
 /// High-level taxonomy of application errors (stable categories).
 pub use crate::AppErrorKind;
-/// Convenience alias `Result<T, AppError>` used in handlers/services.
+/// Convenience alias for returning [`AppError`] from handlers/services.
 pub use crate::AppResult;
 /// Stable wire-level error payload for HTTP APIs.
 pub use crate::ErrorResponse;