ce doccomments

Author: tayloraswift

Sources/UnidocDB/Mongo.CollectionModel.swift

@@ -100,7 +100,7 @@ extension Mongo.CollectionModel where Capacity == (bytes:Int, count:Int?)
 extension Mongo.CollectionModel
 {
     /// Creates any necessary indexes for this collection. Do not call this directly; call
-    /// the ``setup(with:)`` method instead.
+    /// the ``setup(with:)`` method instead. (Unless you are ``setup(with:)``.)
     private
     func setupIndexes(with session:Mongo.Session) async throws
     {

Sources/UnidocDB/Packages/Unidoc.PackageMetadata.swift

@@ -29,8 +29,8 @@ extension Unidoc
         /// Indicates whether this package is hidden from the public.
         public
         var hidden:Bool
-
-        /// The current realm this package belongs to. A package can change realms.
+        /// The current realm this package belongs to. A package can change realms, or lack one
+        /// entirely.
         public
         var realm:Realm?
         /// Indicates if this package is currently undergoing realm alignment.