diff --git a/pubky-homeserver/src/core/database/mod.rs b/pubky-homeserver/src/core/database/mod.rs
index cf4e9e4..5aea146 100644
--- a/pubky-homeserver/src/core/database/mod.rs
+++ b/pubky-homeserver/src/core/database/mod.rs
@@ -72,8 +72,8 @@ mod protected {
 }
 
 /// calculate optimal chunk size:
-/// - https://lmdb.readthedocs.io/en/release/#storage-efficiency-limits
-/// - https://github.com/lmdbjava/benchmarks/blob/master/results/20160710/README.md#test-2-determine-24816-kb-byte-values
+/// - <https://lmdb.readthedocs.io/en/release/#storage-efficiency-limits>
+/// - <https://github.com/lmdbjava/benchmarks/blob/master/results/20160710/README.md#test-2-determine-24816-kb-byte-values>
 fn max_chunk_size() -> usize {
     let page_size = page_size::get();
 
diff --git a/pubky-homeserver/src/core/database/tables/entries.rs b/pubky-homeserver/src/core/database/tables/entries.rs
index cc4e7d1..d3f3d07 100644
--- a/pubky-homeserver/src/core/database/tables/entries.rs
+++ b/pubky-homeserver/src/core/database/tables/entries.rs
@@ -113,7 +113,7 @@ impl DB {
 
     /// Return a list of pubky urls.
     ///
-    /// - limit defaults to [crate::core::Config::default_list_limit] and capped by [crate::core::Config::max_list_limit]
+    /// - limit defaults to [crate::config::DEFAULT_LIST_LIMIT] and capped by [crate::config::DEFAULT_MAX_LIST_LIMIT]
     pub fn list(
         &self,
         txn: &RoTxn,
diff --git a/pubky-homeserver/src/core/database/tables/events.rs b/pubky-homeserver/src/core/database/tables/events.rs
index 39a6f73..998229a 100644
--- a/pubky-homeserver/src/core/database/tables/events.rs
+++ b/pubky-homeserver/src/core/database/tables/events.rs
@@ -12,7 +12,7 @@ use serde::{Deserialize, Serialize};
 
 use crate::core::database::DB;
 
-/// Event [Timestamp] base32 => Encoded event.
+/// Event [pkarr::Timestamp] base32 => Encoded event.
 pub type EventsTable = Database<Str, Bytes>;
 
 pub const EVENTS_TABLE: &str = "events";
@@ -62,7 +62,7 @@ impl Event {
 impl DB {
     /// Returns a list of events formatted as `<OP> <url>`.
     ///
-    /// - limit defaults to [crate::Config::default_list_limit] and capped by [crate::Config::max_list_limit]
+    /// - limit defaults to [crate::config::DEFAULT_LIST_LIMIT] and capped by [crate::config::DEFAULT_MAX_LIST_LIMIT]
     /// - cursor is a 13 character string encoding of a timestamp
     pub fn list_events(
         &self,
diff --git a/pubky-homeserver/src/core/mod.rs b/pubky-homeserver/src/core/mod.rs
index d81ed82..472cac0 100644
--- a/pubky-homeserver/src/core/mod.rs
+++ b/pubky-homeserver/src/core/mod.rs
@@ -34,7 +34,7 @@ pub(crate) struct AppState {
 }
 
 #[derive(Debug, Clone)]
-/// A side-effect-free Core of the [Homeserver].
+/// A side-effect-free Core of the [crate::Homeserver].
 pub struct HomeserverCore {
     config: CoreConfig,
     pub(crate) router: Router,