fix: update README for clarity and formatting; adjust generator arguments and caching logic

Author: gibahjoe

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "conventionalCommits.scopes": [
+        "generator"
+    ]
+}

README.md

@@ -145,14 +145,17 @@ sending your PRs.
 
 ## Features and bugs
 
-###Note:
+### 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.
+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.
 
 If the issue is specifically with the generated code, please open your issue in the original OpenAPI Generator repository.
 

example/build.yaml

@@ -0,0 +1,6 @@
+targets:
+  $default:
+    sources:
+      - $package$
+      - lib/**
+      - tictactoe.yaml

example/lib/main.dart

@@ -1,4 +1,3 @@
-// Openapi Generator last run: : 2025-03-07T19:34:28.647173
 import 'package:flutter/material.dart';
 import 'package:openapi_generator_annotations/openapi_generator_annotations.dart';