Co-authored-by: orange-cpp <59374393+orange-cpp@users.noreply.github.com>
Adds comprehensive documentation for the pattern scanning API. Details parsing behavior, complexity, and usage examples. Includes troubleshooting tips and minimal test sketches. Clarifies edge-case handling and implementation notes.