[Docs] Add docs for user_project properties

lib/cocoapods/installer/analyzer/target_inspection_result.rb

@@ -36,6 +36,8 @@ module Pod
         #
         attr_accessor :recommends_frameworks
 
+        # @return [Xcodeproj::Project] the user's Xcode project
+        #
         attr_accessor :project
       end
     end

lib/cocoapods/installer/analyzer/target_inspector.rb

@@ -25,6 +25,8 @@ module Pod
 
         # Inspect the #target_definition
         #
+        # @raise If no `user_project` is set
+        #
         # @return [TargetInspectionResult]
         #
         def compute_results
@@ -74,6 +76,9 @@ module Pod
           path
         end
 
+        # @return [Xcodeproj::Project] the user's Xcode project, used for target
+        #         inspection
+        #
         attr_accessor :user_project
 
         #-----------------------------------------------------------------------#

lib/cocoapods/installer/post_install_hooks_context.rb

@@ -8,6 +8,8 @@ module Pod
       #
       attr_accessor :sandbox_root
 
+      # @return [Project] The Pods Xcode project.
+      #
       attr_accessor :pods_project
 
       # @return [Array<UmbrellaTargetDescription>] The list of
@@ -50,6 +52,9 @@ module Pod
       # Pure data class which describes and umbrella target.
       #
       class UmbrellaTargetDescription
+        # @return [Xcodeproj::Project] The user project into which this target
+        #         is integrated.
+        #
         attr_accessor :user_project
 
         # @return [String] The path of the user project

lib/cocoapods/target/aggregate_target.rb

@@ -54,6 +54,9 @@ module Pod
     #
     attr_accessor :client_root
 
+    # @return [Xcodeproj::Project] the user project that this target will
+    #         integrate as identified by the analyzer.
+    #
     attr_accessor :user_project
 
     # @return [Pathname] the path of the user project that this target will
@@ -73,9 +76,6 @@ module Pod
 
     # List all user targets that will be integrated by this #target.
     #
-    # @param  [Xcodeproj::Project] project
-    #         The project to search for the user targets
-    #
     # @return [Array<PBXNativeTarget>]
     #
     def user_targets