[Claude] improve documentation

[lneto]

use Calude to improve LDoc documentation, making it more concise, simplified, straight to the point, clear, prettier ;-)

[amitraghvan]

Hi @lneto, I have submitted a PR that improves the LDoc documentation across 14 files (both Lua and C). The changes focus on making descriptions more concise, direct, and consistent, while using proper @tparam/@treturn tags throughout. Total comment lines reduced by ~230 without losing API coverage. Happy to make any adjustments based on feedback!