Improve documentation

Author: James Glover

app/resources/v1/pacbio/library_resource.rb

@@ -11,9 +11,9 @@ class LibraryResource < JSONAPI::Resource
 
       has_one :request, always_include_optional_linkage_data: true
       # If we don't specify the relation_name here, jsonapi-resources
-      # attempts to use_related_resource_records_for_joins
-      # In this case I can see it using container_associations
-      # so seems to be linking the wrong tube relationship.
+      # attempts to apply the filters present on `V1::Pacbio::TubeResource`
+      # as defined by `V1::Pacbio::TubeResource#records`. This filters out
+      # all our lovely tubes
       has_one :tube, relation_name: :tube
       has_one :tag, always_include_optional_linkage_data: true
       has_one :pool, always_include_optional_linkage_data: true

app/resources/v1/pacbio/pool_resource.rb

@@ -7,9 +7,9 @@ class PoolResource < JSONAPI::Resource
       model_name 'Pacbio::Pool'
 
       # If we don't specify the relation_name here, jsonapi-resources
-      # attempts to use_related_resource_records_for_joins
-      # In this case I can see it using container_associations
-      # so seems to be linking the wrong tube relationship.
+      # attempts to apply the filters present on `V1::Pacbio::TubeResource`
+      # as defined by `V1::Pacbio::TubeResource#records`. This filters out
+      # all our lovely tubes
       has_one :tube, relation_name: :tube
       has_many :libraries