[tharropoulos]

Change Summary

• annotate each public resource method with description, @example, and @see link sourced from the JS and PHP clients
• split Client's grouped attr_reader into per-resource accessors with YARD blocks so each shows up under hover
• adapt examples to ruby idioms — client.collections['products'] bracket access, string-key hashes, no trailing parens
• keep /29.0/ versioned docs links on legacy AnalyticsV1 and collection-scoped Synonyms, /latest/ everywhere else
• mark AnalyticsV1, Synonyms, and Synonym with @deprecated pointing to the v30 replacements

PR Checklist

• I have read and signed the Contributor License Agreement.