docs: clarify legacy type documentation

[sakul-learning]

Summary

• Add a short footnote explaining that the legacy generated .d.ts files included JSDoc documentation strings
• Clarify that the generator received the same resource documentation used for RAG embeddings, as local structured type context rather than retrieved chunks

Validation

• pnpm verify (passes; 3 existing no-img-element warnings)
• git diff --check