Apply suggestions from code review

Co-authored-by: Martin Vidner <mvidner@suse.cz>

service/lib/agama/config.rb

@@ -95,6 +95,7 @@ def pick_product(product_id)
     end
 
     # hash of available base products for current architecture
+    # @return [Hash{String => Hash}]  product_id => product
     def products
       return @products if @products
 

service/lib/agama/product_reader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) [2022] SUSE LLC
+# Copyright (c) [2023] SUSE LLC
 #
 # All Rights Reserved.
 #
@@ -25,6 +25,7 @@
 
 module Agama
   # This class is responsible for reading available products definition
+  # either from system path (`/usr/share/agama/products.d) or the git repo.
   class ProductReader
     include Yast::I18n
 

service/run_tests_in_container.sh

@@ -12,7 +12,7 @@ if podman exec --workdir /checkout/service agama_ruby_tests rake test:unit; then
   echo "Tests passed"
 else
   echo "Tests failed"
-  echo "To get into container use: podman attach agama_ruby_tests"
-  echo "git checkout is located at /checkout"
-  echo "To remove container use: podman rm agama_ruby_tests"
+  echo "To get into container use:"; echo "  podman attach agama_ruby_tests"
+  echo "  cd /checkout"
+  echo "To remove container use:"; echo "  podman rm agama_ruby_tests"
 fi