Simplify help message system - use hardcoded message

Remove dynamic extraction from README.md and use a consistent hardcoded
help message throughout the codebase. The markdown-to-terminal conversion
proved too fragile for reliable use.

- Remove extract_troubleshooting_section and related helper methods
- Update all error classes to use Utils.default_troubleshooting_section
- Remove documentation comment about marker usage from README
- Keep the well-formatted hardcoded support message with URLs

This provides a more reliable and maintainable approach to displaying
help information in error messages.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: justin808

README.md

@@ -141,7 +141,6 @@ _Requires creating a free account._
 - A JavaScript package manager (npm, yarn, pnpm, or bun)
 
 <!-- TROUBLESHOOTING_LINKS_START -->
-<!-- NOTE: Content between TROUBLESHOOTING_LINKS markers is dynamically extracted and displayed in error messages -->
 # 🆘 Get Help & Support
 
 **Need immediate help?** Here are your options, ordered by response time:

lib/react_on_rails/json_parse_error.rb

@@ -7,7 +7,7 @@ class JsonParseError < ::ReactOnRails::Error
     def initialize(parse_error:, json:)
       @json = json
       @original_error = parse_error
-      message = "#{parse_error.message}\n\n#{Utils.extract_troubleshooting_section}"
+      message = "#{parse_error.message}\n\n#{Utils.default_troubleshooting_section}"
       super(message)
     end
 

lib/react_on_rails/prerender_error.rb

@@ -85,7 +85,7 @@ def calc_message(component_name, console_messages, err, js_code, props)
       end
 
       # Add help and support information
-      message << "\n#{Utils.extract_troubleshooting_section}\n"
+      message << "\n#{Utils.default_troubleshooting_section}\n"
 
       [backtrace, message]
     end

lib/react_on_rails/server_rendering_pool/ruby_embedded_java_script.rb

@@ -77,7 +77,7 @@ def exec_server_render_js(js_code, render_options, js_evaluator = nil)
             if err.message.include?("ReferenceError: self is not defined")
               msg << "\nError indicates that you may have code-splitting incorrectly enabled.\n"
             end
-            msg << "\n#{Utils.extract_troubleshooting_section}\n"
+            msg << "\n#{Utils.default_troubleshooting_section}\n"
             raise ReactOnRails::Error, msg, err.backtrace
           end
 
@@ -123,7 +123,7 @@ def read_bundle_js_code
         rescue StandardError => e
           msg = "You specified server rendering JS file: #{server_js_file}, but it cannot be " \
                 "read. You may set the server_bundle_js_file in your configuration to be \"\" to " \
-                "avoid this warning.\nError is: #{e}\n\n#{Utils.extract_troubleshooting_section}"
+                "avoid this warning.\nError is: #{e}\n\n#{Utils.default_troubleshooting_section}"
           raise ReactOnRails::Error, msg
         end
 
@@ -151,7 +151,7 @@ def create_js_context
                   "See file #{file_name} to " \
                   "correlate line numbers of error. Error is\n\n#{e.message}" \
                   "\n\n#{e.backtrace.join("\n")}" \
-                  "\n\n#{Utils.extract_troubleshooting_section}"
+                  "\n\n#{Utils.default_troubleshooting_section}"
             Rails.logger.error(msg)
             trace_js_code_used("Error when compiling JavaScript code for the context.", base_js_code,
                                file_name, force: true)
@@ -229,7 +229,7 @@ def file_url_to_string(url)
           encoding_type = match[:encoding]
           response.body.force_encoding(encoding_type)
         rescue StandardError => e
-          msg = "file_url_to_string #{url} failed\nError is: #{e}\n\n#{Utils.extract_troubleshooting_section}"
+          msg = "file_url_to_string #{url} failed\nError is: #{e}\n\n#{Utils.default_troubleshooting_section}"
           raise ReactOnRails::Error, msg
         end
 

lib/react_on_rails/utils.rb

@@ -58,7 +58,7 @@ def self.invoke_and_exit_if_failed(cmd, failure_message)
 
         puts wrap_message(msg)
         puts ""
-        puts extract_troubleshooting_section
+        puts default_troubleshooting_section
 
         # Rspec catches exit without! in the exit callbacks
         exit!(1)
@@ -281,40 +281,7 @@ def self.prepend_to_file_if_text_not_present(file:, text_to_prepend:, regex:)
       puts "Prepended\n#{text_to_prepend}to #{file}."
     end
 
-    # Extract troubleshooting section from README.md for error messages
-    def self.extract_troubleshooting_section
-      readme_path = File.join(gem_root, "README.md")
-      return default_troubleshooting_section unless File.exist?(readme_path)
-
-      readme_content = File.read(readme_path)
-
-      # Extract content between the markers
-      start_marker = "<!-- TROUBLESHOOTING_LINKS_START -->"
-      end_marker = "<!-- TROUBLESHOOTING_LINKS_END -->"
-
-      if readme_content.include?(start_marker) && readme_content.include?(end_marker)
-        start_pos = readme_content.index(start_marker) + start_marker.length
-        end_pos = readme_content.index(end_marker)
-
-        extracted = readme_content[start_pos...end_pos].strip
-        # Convert markdown to terminal-friendly text
-        convert_markdown_to_terminal(extracted)
-      else
-        default_troubleshooting_section
-      end
-    rescue StandardError
-      default_troubleshooting_section
-    end
-
-    private_class_method def self.convert_markdown_to_terminal(markdown_text)
-      markdown_text
-        .gsub(/^#+\s+(.+)$/, "\n📞 \\1") # Convert H1-H6 headers
-        .gsub(/\*\*(.+?)\*\*/, "\\1") # Remove bold markdown
-        .gsub(/\[([^\]]+)\]\(([^)]+)\)/, "\\1: \\2") # Convert links to "text: url"
-        .gsub(/^-\s+/, "   • ") # Convert bullets
-    end
-
-    private_class_method def self.default_troubleshooting_section
+    def self.default_troubleshooting_section
       <<~DEFAULT
         📞 Get Help & Support:
            • 🚀 Professional Support: [email protected] (fastest resolution)
@@ -323,9 +290,5 @@ def self.extract_troubleshooting_section
            • 📖 Discussions: https://github.com/shakacode/react_on_rails/discussions
       DEFAULT
     end
-
-    private_class_method def self.gem_root
-      File.expand_path("../..", __dir__)
-    end
   end
 end