chore: more fixes, more docs

Author: m4tx

flareon/src/db.rs

@@ -73,6 +73,7 @@ impl DatabaseError {
     }
 }
 
+/// An alias for [`Result`] that uses [`DatabaseError`] as the error type.
 pub type Result<T> = std::result::Result<T, DatabaseError>;
 
 /// A model trait for database models.
@@ -211,6 +212,8 @@ impl Column {
     }
 }
 
+/// A marker trait that denotes that a type can be used as a primary key in a
+/// database.
 pub trait PrimaryKey: DatabaseField + Clone {}
 
 /// A row structure that holds the data of a single row retrieved from the
@@ -913,7 +916,7 @@ pub struct RowsNum(pub u64);
 /// ```
 /// use flareon::db::{model, Auto, Model};
 /// # use flareon::db::migrations::{Field, Operation};
-/// # use flareon::db::{Database, Identifier};
+/// # use flareon::db::{Database, Identifier, DatabaseField};
 /// # use flareon::Result;
 ///
 /// #[model]
@@ -925,7 +928,7 @@ pub struct RowsNum(pub u64);
 /// # async fn main() -> Result<()> {
 ///
 /// # const OPERATION: Operation = Operation::create_model()
-/// #     .table_name(Identifier::new("todoapp__my_model"))
+/// #     .table_name(Identifier::new("my_model"))
 /// #     .fields(&[
 /// #         Field::new(Identifier::new("id"), <i32 as DatabaseField>::TYPE)
 /// #             .primary_key()
@@ -1025,6 +1028,8 @@ impl<const LIMIT: u32> PartialEq<LimitedString<LIMIT>> for String {
     }
 }
 
+/// An error returned by [`LimitedString::new`] when the string is longer than
+/// the specified limit.
 #[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash, Error)]
 #[error("string is too long ({length} > {LIMIT})")]
 pub struct NewLimitedStringError<const LIMIT: u32> {

flareon/src/db/relations.rs

@@ -104,7 +104,7 @@ impl From<ForeignKeyOnDeletePolicy> for sea_query::ForeignKeyAction {
     }
 }
 
-/// A foreign key on delete constraint.
+/// A foreign key on update constraint.
 ///
 /// This is used to define the behavior of a foreign key when the referenced row
 /// is updated.