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