diff --git a/lib/dm-core/collection.rb b/lib/dm-core/collection.rb
index <HASH>..<HASH> 100644
--- a/lib/dm-core/collection.rb
+++ b/lib/dm-core/collection.rb
@@ -426,6 +426,9 @@ module DataMapper
     ##
     # Append one Resource to the Collection and relate it
     #
+    # @param [DataMapper::Resource] resource
+    #   the resource to add to this collection
+    # 
     # @return [DataMapper::Collection] self
     #
     # @api public
diff --git a/lib/dm-core/repository.rb b/lib/dm-core/repository.rb
index <HASH>..<HASH> 100755
--- a/lib/dm-core/repository.rb
+++ b/lib/dm-core/repository.rb
@@ -35,8 +35,8 @@ module DataMapper
     # @return [DataMapper::Adapters::AbstractAdapter]
     #   the adapter for this repository
     # @raise [ArgumentError]
-    #   if there is no adapter registered for a repository with name +@name+
-    # @api ???
+    #   if there is no adapter registered for a repository named +name+
+    # @api semipublic
     def adapter
       # Make adapter instantiation lazy so we can defer repository setup until it's actually
       # needed. Do not remove this code.
Tiny API doc cleanups.