Add AI Agent friendly documentation

[duncanpo]

AI Agents struggles with syntax such as implicit context passing (makeCurrent), RAII pattern of span and scope objects, and global Tracer Provider. They need more documentation to guide them to generate good instrumentation code.