docs: 📝 Updated issue template, readme.md

Updated issue template to include information about opening issues in base library.

Author: gibahjoe

.github/ISSUE_TEMPLATE/1-bug-report.yaml

@@ -9,6 +9,32 @@ body:
         Thank you for taking the time to fill out this bug report!
         Please note that contributor time is limited, and we might not get back to you immediately.
         Also make sure to check if [an existing issue](https://github.com/gibahjoe/openapi-generator-dart/issues) matches yours.
+  
+  - type: markdown
+    attributes:
+      value: |
+        **Please read before submitting:**  
+        This library wraps the [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator) to provide Dart/Flutter codegen.  
+        Some issues may come from the underlying generator, not from this library.
+        If the issue you are experiencing is related to the generated code, then you need to open an issue on the [OpenAPI Generator repo](https://github.com/OpenAPITools/openapi-generator/issues).
+        [Click here to learn more](https://github.com/gibahjoe/openapi-generator-dart#note)
+        
+  - type: dropdown
+    attributes:
+      label: Is your issue related to the code that was generated?
+      options:
+        - No, my issue is with the openapi-generator-dart wrapper/config
+        - Yes, my issue is with the generated code (e.g. code errors, structure)
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        > **If your issue is with the generated code, please [open it on the base OpenAPI Generator repo](https://github.com/OpenAPITools/openapi-generator/issues) instead.**
+        >
+        > Issues with generated code are usually caused by the underlying OpenAPI Generator tool, not this wrapper.
+
   - type: textarea
     attributes:
       label: Description of the bug

.gitignore

@@ -22,3 +22,5 @@ pubspec_overrides.yaml
 
 .iml
 openapi_generator_config.json
+
+**/.cxx/

README.md

@@ -145,8 +145,19 @@ sending your PRs.
 
 ## Features and bugs
 
-Please file feature requests and bugs at the [issue tracker][tracker].
+###Note:
+
+Some issues may originate from the base OpenAPI Generator library rather than this Dart/Flutter wrapper. This library provides Dart-specific configuration and tools, but the actual code generation is handled by the underlying OpenAPI Generator.
+
+If you encounter problems with the generated code (such as incorrect imports, unexpected code structure, or type mismatches), these are often caused by the base generator, not this wrapper. You may be able to resolve some of these issues by customizing the @Openapi() annotation options:
+	•	template: Allows you to specify a custom code generation template, helping fix issues related to the structure or style of the generated code.
+	•	importMappings: Lets you map OpenAPI model names to custom Dart imports, which helps fix problems with incorrect or missing import statements in the generated code.
+	•	typeMappings: Allows you to map OpenAPI schema types to your own Dart types, which is useful for resolving issues where generated classes don’t match your project’s types or when you need to substitute types for better compatibility.
 
-[tracker]: https://github.com/gibahjoe/openapi-generator-dart/issues
+If the issue is specifically with the generated code, please open your issue in the original OpenAPI Generator repository.
+
+If you’re unsure where the problem comes from, feel free to open an issue here—we’ll help point you in the right direction.
+
+Please file feature requests and bugs at the [issue tracker][tracker].
 
-<a href="https://www.buymeacoffee.com/gibahjoe" target="_blank"><img src="https://bmc-cdn.nyc3.digitaloceanspaces.com/BMC-button-images/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: auto !important;width: auto !important;" ></a>
+[tracker]: https://github.com/gibahjoe/openapi-generator-dart/issues

example/lib/main.dart

@@ -1,3 +1,4 @@
+// Openapi Generator last run: : 2025-03-07T19:34:28.647173
 import 'package:flutter/material.dart';
 import 'package:openapi_generator_annotations/openapi_generator_annotations.dart';
 
@@ -124,4 +125,4 @@ class _MyHomePageState extends State<MyHomePage> {
       ), // This trailing comma makes auto-formatting nicer for build methods.
     );
   }
-}
+}