docs: Small tweaks

bitflags-attr-macros/src/lib.rs

@@ -5,9 +5,9 @@ use typed::{Args, Bitflag};
 
 mod typed;
 
-/// An attribute macro that transforms an C-like enum into a bitflag struct type implementing an API
-/// similar to the `bitflags` crate, and implementing many helpful traits (listed in more details
-/// below).
+/// An attribute macro that transforms an C-like enum into a bitflag struct type implementing an
+/// ergonomic end-user API, similar to the `bitflags` crate, and implementing many helpful traits
+/// (listed in more details below).
 ///
 /// The attribute requires that the [`Clone`] and [`Copy`] traits are derived for the type.
 ///

src/lib.rs

@@ -29,8 +29,8 @@
 //!
 //! Here is a non-exhaustive list of the things that `bitflag-attr` supports:
 //!
-//! - `no_std` support with opt-in options to use `alloc` and `std`
 //! - Ergonomically create a flags type from native C-like enum syntax
+//! - `no_std` support with opt-in options to use `alloc` and `std`
 //! - Generate ergonomic API for the generated flags type
 //! - Generated methods are almost entirely const-compatible
 //! - Generated flags type auto-implements several convenient traits (complete list in the